review-my-code

AI-powered code review CLI using Claude — checks clean code, reusability, and best practices instantly.

Requirements

• Claude Code CLI installed and logged in
• Node.js >= 16

Installation

Install as a dev dependency in your project:

npm install -D review-my-code

Usage

Review your entire project:

npx review-my-code

Review a specific folder:

npx review-my-code src/

Review a specific file:

npx review-my-code src/index.js

What it checks

• ✅ Clean Code — naming, readability, dead code, single responsibility
• ✅ Reusability — duplicate logic, DRY principle, abstractions
• ✅ Best Practices — error handling, async/await, security, anti-patterns
• ✅ Performance — unnecessary re-renders, expensive loops, memoization
• ✅ Security — unsanitized inputs, hardcoded secrets, insecure API calls

How it works

On first run, it automatically installs a Claude Code agent (code-quality-reviewer) into your ~/.claude/agents/ folder. After that, every time you run review-my-code, it launches Claude Code with the agent to review your code and gives structured feedback with severity levels:

• 🔴 Critical — must fix
• 🟡 Warning — should fix
• 🟢 Suggestion — nice to have

Example output

🔍 Running code review on: /Users/bishnu/my-project/src

🔴 Critical: getUserData() and fetchUserInfo() contain duplicate logic — extract to a shared service
🟡 Warning: Missing error handling in async function processOrder()
🟢 Suggestion: Consider memoizing the filtered list in UserList component

License

MIT © bishnukant1996