DEV Community

Timmothy
Timmothy

Posted on

I Built a Free CLI That Reviews Your PRs with AI (One Command, Zero Setup)

#productivity #github #devops #ai

I got tired of waiting for code reviews. So I built a tool that does it in 10 seconds.

The Problem

You open a PR. You wait. Hours pass. Maybe a day. The reviewer finally looks at it, spots a bug you should have caught, and now you need another round.

What if you could get an AI review before the human one?

The Tool

ai-review is a single bash script that:

  1. Fetches your PR diff from GitHub
  2. Sends it to Claude for analysis
  3. Returns a structured review: Summary, Risks, Suggestions, Confidence Score 
ai-review --pr https://github.com/owner/repo/pull/123
Enter fullscreen mode Exit fullscreen mode

That's it. No npm install. No Docker. No config files.

What You Get 

## 📋 Summary
Refactors the auth module to use database-backed sessions
instead of JWTs, improving security and enabling revocation.

## ⚠️ Identified Risks
- Session table has no index on expires_at — queries will
  slow down as sessions accumulate
- No rate limiting on session creation endpoint

## 💡 Suggestions
- Add a cleanup job for expired sessions
- Index the expires_at column
- Consider session pooling for high-traffic scenarios

## 🎯 Confidence: High
Clear, well-scoped changes with straightforward logic.
Enter fullscreen mode Exit fullscreen mode

Run It as a GitHub Action

Every PR gets an automatic AI review:

name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: AI Review
        env:
          CLAUDE_API_KEY: ${{ secrets.CLAUDE_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          curl -fsSL https://raw.githubusercontent.com/JuanM94/ai-review/main/ai-review | bash -s -- \
            --pr "${{ github.repository }}/${{ github.event.pull_request.number }}" \
            --post
Enter fullscreen mode Exit fullscreen mode

Why Not Just Use Copilot/CodeRabbit/etc?

Those are great. This is different:

  • Zero dependencies — bash + curl + python3 (already on your machine)
  • No account needed — just an API key
  • Transparent — 200 lines of readable bash, not a black box
  • Free to self-host — you pay only for API calls (~$0.01-0.05 per review)

Try It 

export CLAUDE_API_KEY="your-key"
curl -fsSL https://raw.githubusercontent.com/JuanM94/ai-review/main/ai-review | bash -s -- --pr facebook/react/28000
Enter fullscreen mode Exit fullscreen mode

⭐ Star on GitHub if you find it useful.

I build developer tools and hunt GitHub bounties for a living. More tools at juanm94.github.io/timmy-tools.

Top comments (0)