Agent Setup

Set up CorgReview with your AI coding agent.

Supported agents

Agent	CLI Mode	MCP Mode	Skill Location
Claude Code	Yes	Yes	.claude/skills/corg/SKILL.md
Cursor	Yes	Yes	.cursor/rules/corg-review.mdc
Windsurf	Yes	Yes	.windsurf/rules/corg-review.md
Codex	Yes	No	AGENTS.md (appended)
OpenCode	Yes	No	.opencode/agents.md (appended)

Quick setup

Run corg init in your project. CorgReview auto-detects your agent and installs the appropriate skill file.

$ corg init
Detected agents:
  1. Claude Code
  2. Cursor
Select agent [1]: 1
✓ Installed skill for Claude Code

Agent detection

Auto-detection checks for these directories and files:

~/.claude/ — Claude Code
~/.cursor/ or .cursor/ — Cursor
~/.windsurf/ or .windsurf/ — Windsurf
AGENTS.md in project — Codex
.opencode/ in project — OpenCode

If multiple agents are detected, you'll be prompted to choose. If none are detected, defaults to Claude Code.

CLI mode vs MCP mode

CLI mode (default, recommended)

Installs a skill file that tells your agent to run corg review --json directly. No MCP server configuration needed. Works with any agent that can run shell commands.

corg init --agent claude

MCP mode

Configures an MCP server in the agent's config and installs a skill referencing the MCP tool. Supported for Claude Code, Cursor, and Windsurf.

corg init --agent claude --mcp

Claude Code

# CLI mode (recommended)
corg init --agent claude

# MCP mode
corg init --agent claude --mcp

# Global install (applies to all projects)
corg init --agent claude --global

In CLI mode, the installed skill teaches Claude Code to run corg review --json after completing a task. In MCP mode, Claude Code calls the request_human_review tool.

Cursor

corg init --agent cursor

Installs a .mdc rule file that Cursor reads as an agent rule.

Windsurf

corg init --agent windsurf

Installs a markdown rule file in the Windsurf rules directory.

Codex

corg init --agent codex

Appends CorgReview instructions to your project's AGENTS.md file.

OpenCode

corg init --agent opencode

Appends CorgReview instructions to .opencode/agents.md.

Overwrite protection

If a skill file already exists, corg init will notify you and exit. Use --force to overwrite.