@ebrahimelsafadedev/custom-ai-code-reviewer

Type /review in Cursor or Claude Code. Get structured, rule-based code review reports saved to dated folders.

Integrates with Cursor, Claude Code, GitHub Copilot, Windsurf, Continue.dev, Zed AI, and Sourcegraph Cody.

Install

npm install --save-dev @ebrahimelsafadedev/custom-ai-code-reviewer

Setup runs automatically on install (copies rules, creates reviewed/, writes slash commands).

To re-sync after adding a new category:

npx @ebrahimelsafadedev/custom-ai-code-reviewer

No token. No .npmrc. Works for everyone.

What setup does

Step 1 — Loads review-rules/*.md from the package
Step 2 — Copies rule files to your project + creates reviewed/
Step 3 — Writes real slash commands for Cursor and Claude Code
Step 4 — Adds review:list script to package.json

Cursor: .cursor/commands/review.md, .cursor/commands/review-accessibility.md, etc.

Claude Code: .claude/commands/review.md, .claude/commands/review-accessibility.md, etc.

Usage

After install, open the / slash command menu in Cursor or Claude Code. You should see:

| Command | Reviews | |---------|---------| | /review | Show command menu (no review run) | | /review-all | All categories at once | | /review-accessibility | Accessibility | | /review-code-quality-conventions | Code Quality & Conventions | | /review-form-architecture | Form Architecture | | /review-json-schema-design | JSON Schema Design | | /review-performance | Performance | | /review-validation-error-handling | Validation & Error Handling |

Pick a category command. The AI asks for scope (current file or whole project), runs the review, and writes the report to disk.

Important: Use Agent mode in Cursor so the AI can create files. In Ask mode, reports stay in chat only.

Cursor tip: Pick the project's /review command from .cursor/commands/, not Cursor's built-in generic review command.

Output

reviewed/
  19-05-2026/
    accessibility-reviewed.md
    performance-reviewed.md
  README.md   ← auto-updated index

Past runs are never overwritten. Same-day re-runs get a timestamp suffix.

Chat replies are a short summary + file path only — full findings live in reviewed/.

Adding a new review category

1. Drop a <name>-rules.md file into review-rules/
2. Re-run npx @ebrahimelsafadedev/custom-ai-code-reviewer
3. /review-<name> appears in .cursor/commands/ and .claude/commands/

Supported AI tools

| Tool | Primary integration | |------|---------------------| | Cursor | .cursor/commands/*.md slash commands | | Claude Code | .claude/commands/*.md slash commands + CLAUDE.md pointer | | GitHub Copilot | .github/copilot-instructions.md | | Windsurf | .windsurfrules | | Continue.dev | .continue/config.json | | Zed AI | .zed/settings.json | | Sourcegraph Cody | .cody/context.md |

Troubleshooting

| Problem | Fix | |---------|-----| | Setup didn't run | Run npx @ebrahimelsafadedev/custom-ai-code-reviewer from your project root | | Only generic /review shows | Use commands from .cursor/commands/ — not Cursor's built-in review | | No files in reviewed/ | Switch to Agent mode; Ask mode cannot write files | | Commands missing after upgrade | Re-run npx @ebrahimelsafadedev/custom-ai-code-reviewer |

License

MIT