🔥 roast-my-repo

AI-powered brutal code roasts for your GitHub repos. One command, zero mercy.

npx roast-my-repo facebook/react

What it does

1. Clones your repo
2. Analyzes everything — file structure, tests, CI, dependencies, git history, code quality signals
3. Feeds it all to an AI with zero chill
4. Outputs a devastating, funny, technically accurate roast

Example output

╔════════════════ ROAST-MY-REPO ════════════════╗
║                                               ║
║   💀  69 Console Logs and a God Complex  💀   ║
║                                               ║
║   Overall: ████░░░░░░ 4.2/10                  ║
║                                               ║
╚═══════════════════════════════════════════════╝

Categories scored: Code Quality, Architecture, Testing, Documentation, DevOps, Dependencies.

Plus: highlight reel, worst offense, and one backhanded piece of advice.

Setup

Option 1: Anthropic API key (best quality)

export ANTHROPIC_API_KEY=sk-ant-...
npx roast-my-repo owner/repo

Get a key at console.anthropic.com

Option 2: Ollama (free, local)

brew install ollama
ollama pull llama3.2:3b
npx roast-my-repo owner/repo

The tool auto-detects which provider is available.

Usage

# GitHub URL
npx roast-my-repo https://github.com/facebook/react

# Shorthand
npx roast-my-repo facebook/react

# Help
npx roast-my-repo --help

What gets analyzed

• Files: count, extensions, sizes, deepest nesting
• Code quality: TODOs/FIXMEs, console.logs, average file size
• Testing: test file count, test frameworks detected
• CI/CD: GitHub Actions, CircleCI, Travis
• Dependencies: production vs dev count, lock files
• Git history: commit count, last commit date, top committers
• Code samples: actual code snippets for AI to roast

Environment variables

| Variable | Description | Default | |----------|-------------|---------| | ANTHROPIC_API_KEY | Anthropic API key | - | | OLLAMA_HOST | Ollama server URL | http://localhost:11434 | | OLLAMA_MODEL | Ollama model to use | auto-detected |

Share your roast

Screenshot your terminal and post to X with #roastmyrepo

License

MIT