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

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

# 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

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