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 — posting 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

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

How It Works

  1. The CLI collects the relevant diff based on your flags
  2. Local source files are gathered for RAG context to improve accuracy
  3. Changes are streamed to the Codity analysis engine via SSE
  4. Review comments are displayed in real-time as they are generated

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 and suggested fix