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, -r | Path to git repository | Current directory |
| --port, -p | HTTP server port | 9847 |
| --output-dir, -o | Directory for review files | .corg/reviews |
| --no-browser | Don't auto-open browser | false |
| --json | Output result as JSON (for scripting) | false |
| --agent | Agent name to record in review metadata | none |
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, -p | HTTP server port | 9847 |
| --repo, -r | Path to git repository | Current 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 reviewwhich 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 |
|---|---|---|
| --agent | Explicitly select agent | Auto-detect |
| --global | Install to user-level config | false (project-level) |
| --mcp | Use MCP mode instead of CLI | false |
| --force, -f | Overwrite existing skill file | false |
# 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 |
| status | Show current license status |
| deactivate | Deactivate current license |
corg version
Display version, git commit hash, and build timestamp.