Skip to main content

​
Review local changes

The CodeRabbit CLI analyzes local Git changes using the same pattern recognition that powers our PR reviews. By default, it reviews tracked changes: committed changes, staged changes (including new files added with git add), and unstaged edits to tracked files. Use --uncommitted to review only staged and tracked local edits. Files not added to Git are skipped unless you pass --include-untracked.

​
Key features

Review local changes

Catch bugs before they reach your repository. CodeRabbit scans committed and uncommitted Git changes for race conditions, null pointer exceptions, and logic errors.

Apply fixes in one step

Fix simple issues like missing imports or syntax errors instantly. For complex architectural problems, send the full context directly to your AI coding agent.

Context-aware reviews

Paid plans unlock reviews powered by your team’s codebase history: error handling conventions, architectural patterns, and coding preferences applied automatically to every review.

Install agent skills

Run coderabbit skills to preview and install or update verified CodeRabbit skills for supported coding agents.

​
Getting started

1

Install CLI

Download and install the CodeRabbit CLI using your preferred method.
After installation, restart your shell or reload your shell configuration:
2

Authenticate

Link your CodeRabbit account to enable personalized reviews based on your team’s patterns.
A browser window opens automatically. Sign in to CodeRabbit and the authentication completes in the browser.If your account has access to multiple CodeRabbit organizations, choose your default organization during sign-in. That choice sets the login/default org for browser-based auth, but CLI reviews still resolve the current repository first. You can change the default later with cr auth org.If browser sign-in is blocked or unavailable, authenticate with an Agentic API key instead:
API-key authentication uses the key’s organization and is also the recommended flow for headless or bot-driven environments. Reviews use the assigned user’s plan allowance first, then usage credits only for eligible over-limit reviews when the usage-based add-on is enabled.
3

Review your code

Analyze your Git repository for issues using the CodeRabbit CLI.
Git repository required: The CLI must be run from within an initialized Git repository. The --dir flag changes the review directory, but that directory must also contain a Git repository.
If your main branch is not main, specify your base branch:
CodeRabbit scans the selected Git changes and provides specific feedback with suggested fixes.
4

Verify local setup

If setup, authentication, or review startup fails, run the local diagnostics command:
The command checks installation, local storage, authentication, Git repository state, and CodeRabbit service connectivity.
5

Apply suggestions

Review findings in your terminal and either apply quick fixes or send complex issues to your AI coding agent.

​
Organization selection

The active CodeRabbit organization is the login/default org for browser-based CLI auth. It is used when the current repository resolves to that org, but it is not a silent billing fallback for unrelated local repositories. During a review, CodeRabbit resolves the current repository first:
  • If the repository matches the selected org, the review uses that org.
  • If the repository matches a different org you can access, CodeRabbit switches attribution to that org.
  • If the repository matches an installed public repo but you do not have access to the owning org, the review uses OSS behavior.
  • If the repository cannot be matched to an installed accessible repo, the CLI falls back to limited/free review behavior until CodeRabbit is installed for that repo or org.
To change organizations later, run:
cr auth org opens sign-in automatically if your local session is missing or expired. Organization switching is not available for self-hosted mode or API key authentication.

​
Review modes

The CLI uses plain-text, human-readable output by default, with agent output and an optional lighter policy also available:
The default plain-text mode displays a finding count and severity summary at the end of each run. No output flag is required. If the CLI detects a known agent environment, it suggests re-running with --agent for structured JSON output.

​
Diagnostics

Run cr doctor at any time to verify your local setup. The command checks:
  • CLI runtime and version
  • Local CodeRabbit storage directory
  • Authentication state and auth environment
  • Current Git repository and branch metadata
  • Auto-update policy
  • CodeRabbit backend reachability
  • CodeRabbit WebSocket reachability
cr doctor exits with status code 1 when any check fails. Warnings appear in the report but do not cause a non-zero exit code.

​
Review statistics

Use cr stats to inspect your review statistics from local review history:

​
Working with review results

CodeRabbit analyzes your code and surfaces specific issues with actionable suggestions. Each finding includes the problem location, explanation, and recommended fix. Example findings include:
  • Race condition detected: “This goroutine accesses shared state without proper locking”
  • Memory leak potential: “Stream not closed in error path - consider using defer”
  • Security vulnerability: “SQL query uses string concatenation - switch to parameterized queries”
  • Logic error: “Function returns nil without checking error condition first”

​
Browse and apply suggestions

In plain mode, read each finding in the terminal output and apply the suggested change in your editor or coding agent. For simple issues like missing imports, syntax errors, or formatting problems, use the suggested fix directly. For larger changes, use cr review --agent so your coding agent can consume structured findings.

​
Use AI coding agents

For AI agent integration, see the AI agent integration section for detailed workflow guidance and integration guides.

​
Replay stored findings

Run cr review findings to read results from the most recent local review that produced findings, without re-running the full analysis. This is useful in multi-step agent loops where a downstream step needs to consume results from a prior review.

​
Inspect AI prompts

Run cr review --show-prompts to print the AI prompts saved from the most recent local review without triggering a new review. Useful for tuning --config instructions or understanding why the model flagged a particular finding.

​
AI agent integration

CodeRabbit detects the problems, then your AI coding agent implements the fixes.
Claude Code users: Claude Code now supports CodeRabbit through a native plugin. See the Claude Code integration guide for the recommended plugin-based setup using /coderabbit:review instead of the CLI commands shown below.

​
Integration guides

See detailed workflows for AI coding agents and workflows:

CodeRabbit Skills

Run coderabbit skills to install agent-native Skills and trigger reviews with an explicit request such as “Run a CodeRabbit review.”

Claude Code integration

Automated workflow with background execution and task-based fixes

Codex integration

Integrated code review and fix implementation with Codex CLI

Headless CLI integration

Authenticate CodeRabbit non-interactively in GitHub Actions and other bot-driven automation

​
Example prompt for your AI agent

Here’s a complete prompt you can use with Cursor, Codex, or other AI coding agents:
Sample prompt

​
Components of a good prompt

Breaking down what makes an effective CodeRabbit + AI agent workflow:
Tell your AI agent to run CodeRabbit with the --agent flag:
You can also specify a review scope or base branch:
CodeRabbit reviews can take 7-30+ minutes depending on the scope of changes. Instruct your AI agent to run CodeRabbit in the background and set up a timer to check periodically:
Prompt
Once CodeRabbit completes, have your AI agent evaluate the findings and prioritize:
Prompt
This keeps your agent focused on meaningful improvements rather than minor style issues. If the complete event has status: "review_skipped", there were no file changes in scope.
Run CodeRabbit one more time to ensure fixes didn’t introduce new issues:
Prompt
Prevent infinite iteration by setting clear completion criteria:
Prompt
This ensures your AI agent completes the task efficiently and provides a clear report.

​
Pricing and capabilities

See the rate limits table on the Plans and pricing page for current per-plan limits. To increase the limits, consider upgrading your plan or using the Usage-based Add-on.

Free tier

Basic static analysis with limited daily usage. Catches syntax errors, logic issues, and security vulnerabilities. Eligible Free users may see a Pro+ trial prompt after sign-in or when a CLI review reaches the rate limit.

Paid plans

Enhanced reviews powered by learnings from your CodeRabbit organization plus higher rate limits and more files per review. Paid users reviewing repositories connected to that organization get:
  • Learnings-powered reviews: Remembers your team’s preferred patterns for error handling, state management, and architecture
  • Full contextual analysis: Understands your imports, dependencies, and project structure
  • Team standards enforcement: Applies your documented coding guidelines automatically
  • Advanced issue detection: Spots subtle race conditions, performance bottlenecks, and security vulnerabilities

Usage-based Add-On (Pay-as-you-Go)

Continues eligible CodeRabbit CLI reviews after rate limits
  • Assigned-seat users use their plan allowance first
  • Credits are charged only for eligible over-limit reviews
  • Full control over usage and scaling through the dashboard
  • Flexible purchase options (one-time & monthly subscription)
Contact sales@coderabbit.ai for custom rate limits or enterprise needs.

​
CLI with Usage-based Add-on

The usage-based add-on lets eligible CodeRabbit CLI reviews continue after the applicable review limit is reached. Authenticated CLI and agentic API-key reviews use the assigned user’s plan allowance first. Credits are charged only when a review continues over that limit. Each reviewed file in the over-limit review costs $0.25 in credits. You can purchase credits as a one-time top-up or a recurring monthly subscription from the Subscription and Billing dashboard.
1

Enable the add-on and buy credits

Go to Subscription and Billing and open the Usage-based add-on tab to enable pay-as-you-go and purchase credits.For full setup details, see Manage your subscription.
2

Create an Agentic API key

Navigate to the API Keys section and generate your Agentic API key. The key should be used by a user with an assigned CodeRabbit seat so CLI reviews can use the seat allowance first and usage credits only after the review is rate-limited.
3

Authenticate with your API key

You can pass --api-key KEY to any command directly, but if you plan to make multiple calls, it is more convenient to authenticate once with your CodeRabbit API key:
For GitHub Actions and other non-interactive environments, see Headless CLI integration.
4

Run a CodeRabbit review

After logging in, prompt your agent to run a CodeRabbit CLI review without passing the API key again:
If plan allowance is available, no usage credits are consumed. If the review is rate-limited, the add-on can continue the review only when pay-as-you-go is enabled, credits are available, and the review is attributed to an assigned-seat user.

​
Command reference

See the CLI Command Reference for a complete list of commands and options.

​
Uninstall

Remove CodeRabbit CLI based on how you installed it.
If installed using install script
If installed using Homebrew