codity review

Run AI-powered code review on your local changes before pushing. The review analyzes your code for bugs, security issues, performance problems, and code quality concerns, then posts results directly in your terminal.

Usage

codity review [flags]

Flags

FlagDescription
--stagedReview staged changes only (default)
--allReview all uncommitted changes (staged + unstaged)
--commit <sha>Review a specific commit
--branch <branch>Review changes against a base branch
--fullRun code review, security scan, and code quality scan together

Examples

Review your staged changes:

codity review --staged

Review all uncommitted changes:

codity review --all

Review a specific commit:

codity review --commit abc1234

Review your current branch against main:

codity review --branch main

Run a full local review:

codity review --full --staged

Output JSON for automation:

codity review --json --staged

How It Works

  1. The CLI collects the relevant diff based on your flags
  2. Local source files and Codity context are gathered to improve accuracy
  3. Changes are streamed to Codity for analysis
  4. Review comments are displayed in real time as they are generated
  5. If --full is enabled, security and code quality results are rendered after the review

Output

Each review comment includes:

  • File and line — Exact location of the issue
  • Severity — How critical the finding is
  • Category — Type of issue (bug, security, performance, style, etc.)
  • Message — Description of the problem
  • Suggestion — Recommended fix when available