nimbus diff

Review any diff. Pipe from stdin, pass a revision range, or review staged changes. The same self-improving reviewer used on Nimbus-generated PRs, applied to any diff you give it.

Usage

# Review unstaged changes
nimbus diff

# Review staged changes (pre-commit)
nimbus diff --staged

# Review a revision range
nimbus diff HEAD~3..HEAD
nimbus diff main..feature-branch

# Pipe from stdin
git diff | nimbus diff

# Use in CI — exits 1 if issues found
git diff main | nimbus diff --exit-code --severity=high

Output

  ✗  src/auth/middleware.ts:67
     Bare except clause — catch specific exception types
     Use: except ValueError as e

  ⚠  src/routes/login.ts:42
     Missing error handling if token is expired
     Add a try/catch around jwt.verify()

  overall  needs-work · 1 high issue, 1 medium issue

Flags

Flag	Description
--staged	Review staged changes (git diff --cached)
--severity	Minimum severity to show: low | medium | high
--exit-code	Exit 1 if issues found above threshold (for CI)

CI usage

Add to your pipeline to block PRs with high-severity issues:

- name: Nimbus diff review
  run: git diff origin/main | nimbus diff --exit-code --severity=high
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
    VOYAGE_API_KEY: ${{ secrets.VOYAGE_API_KEY }}