CLI Reference

All commands, flags, and options for the corg CLI.

corg review [range]

Launch the review UI for a commit range. If no range is provided, CorgReview auto-detects your branch and diffs against the base.

Flag Description Default
--repo, -rPath to git repositoryCurrent directory
--port, -pHTTP server port9847
--output-dir, -oDirectory for review files.corg/reviews
--no-browserDon't auto-open browserfalse
--jsonOutput result as JSON (for scripting)false
--agentAgent name to record in review metadatanone

Examples

# Auto-detect: branch review or last commit
corg review

# Review last 3 commits
corg review HEAD~3..HEAD

# Shorthand for HEAD~1..HEAD
corg review HEAD~1

# Specific commit range
corg review abc123..def456

# Custom port, don't open browser
corg review --port 8080 --no-browser

Branch auto-detection

When called with no arguments:

  • If on a feature branch: reviews the full branch diff against the base branch
  • If on the base branch or detached HEAD: reviews the last commit
  • Base branch is auto-detected (main > master > develop), overridable via config
  • Re-running on the same branch resumes the existing review

corg serve

Start the HTTP server with an interactive dashboard for browsing branches and commits.

Flag Description Default
--port, -pHTTP server port9847
--repo, -rPath to git repositoryCurrent directory

Dashboard features

  • Branch comparison — Select base and compare branches, then click "Start Review"
  • Recent commits — Browse commits on any branch, click to review a single commit
  • Custom range — Enter an arbitrary range to review
  • Server stays alive between reviews (unlike corg review which exits after submit)
corg serve
corg serve --repo /path/to/repo
corg serve -p 8080

corg init

Install CorgReview skill for your AI coding agent. See Agent Setup for full details.

Flag Description Default
--agentExplicitly select agentAuto-detect
--globalInstall to user-level configfalse (project-level)
--mcpUse MCP mode instead of CLIfalse
--force, -fOverwrite existing skill filefalse
# Auto-detect agent
corg init

# Explicit agent selection
corg init --agent cursor

# MCP mode (Claude Code, Cursor, Windsurf)
corg init --agent claude --mcp

# Global (user-level) install
corg init --global

corg mcp

Start the MCP server for agent integration (stdio mode). See MCP Integration for full details.

This command is typically run as a subprocess by your AI agent — you don't need to run it manually.

corg license

License management commands.

Subcommand Description
activate <key>Activate a license key
statusShow current license status
deactivateDeactivate current license

corg version

Display version, git commit hash, and build timestamp.