grepper-dev

Local code review powered by AI. Review your code changes before pushing, right from your terminal.

Installation

npm i -g grepper-dev

Or use directly with npx:

npx grepper-dev review

Setup

1. Get your API key from the Grepper dashboard
2. Login with your key:

grepper login

Usage

Review staged changes (default)

grepper review

Review all uncommitted changes

grepper review --all

Review changes against a branch

grepper review --base main

Review specific files

grepper review src/api.ts src/utils.ts

Options

| Option | Description | |--------|-------------| | -s, --staged | Review staged changes only | | -a, --all | Review all uncommitted changes | | -b, --base <branch> | Compare against a branch | | -m, --mode <mode> | Review mode: full, quick, or security | | -f, --format <format> | Output: pretty, json, or markdown | | --fail-on-critical | Exit with code 1 if critical issues found |

Review Modes

• full (default) - Comprehensive review covering all aspects
• quick - Fast review focusing on obvious issues
• security - Security-focused review

Output Formats

• pretty (default) - Colored terminal output
• json - Machine-readable JSON for CI/automation
• markdown - Markdown for documentation or PRs

CI Integration

Use in CI pipelines to catch issues before merge:

- name: Review code
  run: npx grepper-dev review --base main --format json --fail-on-critical

Configuration

Create a .grepper.json in your project root:

{
  "mode": "full",
  "ignore": ["*.test.ts", "dist/**"]
}

The CLI also reads CLAUDE.md and agents.md for project-specific context.

Commands

| Command | Description | |---------|-------------| | grepper login | Authenticate with your API key | | grepper logout | Clear stored credentials | | grepper whoami | Show current user and organization | | grepper review | Review code changes |

License

MIT