create-code-reviewer

Interactive CLI to install a framework-aware code review skill for AI coding assistants.

Quick Start

``bash
npx create-code-reviewer
`

What It Does

1. Detects your project - Package manager, language, framework, styling, testing, linting
2. Configures MCP servers - GitHub, GitLab, Linear, Jira integration
3. Installs code-reviewer skill - Framework-specific rules for AI-assisted code review

Supported AI Tools

- OpenCode - Full support with .opencode/opencode.json config
- Amp / Claude Desktop - claude_desktop_config.json config
- Cursor - Uses OpenCode config format
- Claude Code - Uses OpenCode config format

Supported Frameworks

| Framework | Rules |
|-----------|-------|
| Next.js | Server/Client boundaries, data fetching, image optimization |
| React | Hooks rules, performance, key props |
| Vue 3 | Composition API, reactivity, v-for keys |
| TypeScript | Strict mode, no-any, null checks |
| Django | N+1 queries, security, migrations |
| Express | Async errors, security middleware, input validation |

Installation Scope

- Project (recommended) - Installs to ./.opencode/skills/code-reviewer/
- Global - Installs to ~/.config/opencode/skills/code-reviewer/

Generated Files

`
.opencode/
├── opencode.json # MCP server config
├── code-reviewer.json # Review settings
└── skills/
└── code-reviewer/
├── SKILL.md # Skill instructions
└── references/
├── security-patterns.md
├── performance-patterns.md
├── quality-patterns.md
└── framework-rules/
├── nextjs.md
├── react.md
├── vue.md
├── typescript.md
├── django.md
└── express.md
`

Usage After Installation

`bash


Review a file

opencode "review src/auth.ts"

Review a directory

opencode "review src/services/"

Use slash command

/code-reviewer src/

Review staged changes

/code-reviewer --staged
`

Rule Priority

Rules are applied in this order (highest to lowest priority):

1. AI Instructions - AGENTS.md, CLAUDE.md, .cursorrules
2. Custom rules - User-defined in code-reviewer.json
3. Linting rules - ESLint, Biome, Prettier
4. Framework rules - Next.js, React, Vue, etc.
5. Built-in rules - Security, performance, quality patterns

MCP Server Integration

The installer configures MCP servers for enhanced code review:

| Server | Purpose | Config |
|--------|---------|--------|
| GitHub | PR reviews, issues | npx @anthropic/mcp-server-github |
| GitLab | MR reviews, issues | npx @anthropic/mcp-server-gitlab |
| Linear | Issue tracking | HTTP: https://mcp.linear.app/mcp |
| Jira | Issue tracking | npx @anthropic/mcp-server-jira |

Tokens are stored in .env (gitignored) and referenced via ${env.TOKEN_NAME}.

Configuration

$3

`json
{
"version": "1.0.0",
"project": {
"detected": {
"packageManager": "pnpm",
"language": "typescript",
"framework": "nextjs",
"styling": ["tailwind"],
"linting": ["eslint", "prettier"]
}
},
"rules": {
"framework": {
"nextjs": { "enabled": true }
},
"language": {
"typescript": { "enabled": true, "strict": true }
},
"builtin": {
"security": { "enabled": true },
"performance": { "enabled": true }
},
"custom": []
}
}
`

$3

Add custom rules to code-reviewer.json:

`json
{
"rules": {
"custom": [
{
"name": "no-console-log",
"severity": "warning",
"pattern": "console.log",
"message": "Remove console.log before merging"
}
]
}
}
`

Development

`bash


Clone and install

cd packages/create-code-reviewer
npm install

Build

npm run build

Test locally

node dist/index.js
``

License

MIT