create-code-reviewer

create-code-reviewer

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

Quick Start

npx create-code-reviewer

What It Does

• Detects your project - Package manager, language, framework, styling, testing, linting
• Configures MCP servers - GitHub, GitLab, Linear, Jira integration
• 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

# 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):

• AI Instructions - AGENTS.md, CLAUDE.md, .cursorrules
• Custom rules - User-defined in code-reviewer.json
• Linting rules - ESLint, Biome, Prettier
• Framework rules - Next.js, React, Vue, etc.
• 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

code-reviewer.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": []
  }
}

Custom Rules

Add custom rules to code-reviewer.json:

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

Development

# Clone and install
cd packages/create-code-reviewer
npm install

# Build
npm run build

# Test locally
node dist/index.js

License

MIT