🔥 roast

Gordon Ramsay meets your IDE.

Brutally honest, hilariously harsh AI code reviews — from your terminal.

Your linter tells you what's wrong. Roast tells you why you should be ashamed.

The Problem

Code review tools are boring. ESLint tells you to add a semicolon. TypeScript yells about types. SonarQube generates a 47-page PDF nobody reads.

Meanwhile, your actual code problems — pyramid of doom, god functions, cargo-cult patterns — slide right through.

You don't need another linter. You need someone who cares enough to be mean about it.

The Solution

roast sends your code to an AI with the personality of a furious celebrity chef. You get back:

• 🔪 Savage but accurate feedback on real code smells
• 🎭 Three intensity levels — from gentle nudge to Gordon Ramsay meltdown
• 📝 Actionable fixes hidden inside every insult
• 🌍 Any language — JS, Python, Go, Rust, Java, you name it

Quick Start

npx roast-cli app.js       # Roast any file instantly

Requires OPENAI_API_KEY env var. Get one at platform.openai.com.

Or install globally:

npm install -g roast-cli

Usage

# Roast a file (default: brutal mode)
roast server.js

# Be gentle about it
roast --level mild utils.py

# Medium spice
roast --level medium handler.go

# Roast in Korean (or any supported language)
roast app.js --output-lang ko

# Roast your staged git changes in Japanese
git diff --staged | roast --diff --output-lang ja

# Pipe from anywhere
cat spaghetti.rb | roast

# JSON output for CI/CD integration (machine-readable)
roast app.js --json | jq '.summary'

# Serious mode (professional review, no roasting)
roast --serious production.py

# Use a specific model
roast --model gpt-4o legacy-code.java

Roast Levels

| Level | Vibe | Best For | |-------|------|----------| | --severity mild | Friendly mentor | New devs, PRs you want to keep diplomatic | | --severity medium | Sarcastic senior dev | Team code reviews, your own code | | --severity harsh | Gordon Ramsay 🔥 | Entertainment, humbling yourself, Fridays |

Examples

--severity mild — Friendly Mentor

--severity medium — Sarcastic Senior Dev

--severity harsh — Gordon Ramsay Mode 🔥

Before → After

Before: Your linter output 😴

src/app.js
  3:5  warning  Unexpected var  no-var
  5:22 warning  Use === instead  eqeqeq
  12:1 warning  Missing semicol  semi
  
✖ 3 problems (0 errors, 3 warnings)

Technically correct. Emotionally empty.

After: roast src/app.js 🔥

🔪 Using var in 2026 is like bringing
a flip phone to a tech conference. WHY?!

🔪 == true? If you have to ask a boolean
whether it's true, you have trust issues.

🔪 No semicolons AND no consistency?
Pick a style. ANY style. Please.

Rating: 3/10 — Your code works despite
itself. Barely.

You'll actually remember this feedback.

Multilingual Support

roast can output in multiple languages using the --output-lang flag:

roast app.js --output-lang ko    # Korean
roast app.js --output-lang ja    # Japanese
roast app.js --output-lang es    # Spanish
roast app.js --output-lang fr    # French
roast app.js --output-lang de    # German
roast app.js --output-lang en    # English (default)

The AI maintains the same roasting personality in each language — Gordon Ramsay screams in any tongue.

Configuration

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | OPENAI_API_KEY | ✅ | — | Your OpenAI API key | | ROAST_MODEL | | gpt-4o-mini | Default model | | ROAST_LEVEL | | brutal | Default roast intensity |

Supported Models

Any OpenAI-compatible model works:

• gpt-4o-mini — Fast & cheap (default)
• gpt-4o — Smarter roasts
• gpt-4-turbo — Premium burns
• Any OpenAI-compatible API (Ollama, Together, etc.)

Use Cases

• Pre-PR self-review — Roast your own code before teammates do. Catch embarrassing patterns early.
• Team Friday fun — Run roast --level harsh on the week's worst PR. Winner gets bragging rights.
• Onboarding — New devs roast legacy code to learn what NOT to do (and laugh while doing it).
• CI gate — Auto-roast PRs in GitHub Actions. Real feedback, not just lint warnings.
• Learning tool — Students get memorable feedback that sticks (nobody forgets being called out by Gordon Ramsay).

CI/CD Integration

JSON Output for Automation

Get machine-readable output for CI/CD pipelines:

roast src/app.js --json

Output example:

{
  "version": "1.1.0",
  "timestamp": "2026-03-30T12:00:00Z",
  "file_path": "src/app.js",
  "file_name": "app.js",
  "language": "JavaScript",
  "mode": "roast",
  "severity": "medium",
  "model": "claude-sonnet-4-5-20250929",
  "summary": {
    "total_issues": 5,
    "critical_count": 1,
    "warning_count": 2,
    "suggestion_count": 0,
    "compliment_count": 1,
    "roast_count": 1,
    "has_security_issues": true,
    "has_performance_issues": false,
    "has_bugs": false
  },
  "issues": [
    {
      "id": "issue-1",
      "type": "critical",
      "severity": "high",
      "category": "security",
      "title": "SQL Injection vulnerability",
      "description": "Direct string interpolation in SQL query without sanitization...",
      "code_snippet": "const query = `SELECT * FROM users WHERE id = ${userId}`;",
      "line_number": 42,
      "suggestion": "Use parameterized queries or an ORM..."
    }
  ],
  "raw_review": "🔥 CODE ROAST 🔥\n\n🚨 SQL Injection..."
}

GitHub Actions Example

Add roast to your PR pipeline:

# .github/workflows/roast.yml
name: Roast PR

on:
  pull_request:
    paths:
      - '**.js'
      - '**.ts'
      - '**.py'

jobs:
  roast:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install roast
        run: npm install -g roast-cli
      
      - name: Get changed files
        id: changed-files
        uses: tj-actions/changed-files@v44
        with:
          files: |
            **.js
            **.ts
            **.py
      
      - name: Roast changed files
        if: steps.changed-files.outputs.any_changed == 'true'
        run: |
          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
            echo "🔥 Roasting $file"
            roast "$file" --json --severity medium > "roast-$file.json"
          done
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
      
      - name: Check for critical issues
        run: |
          CRITICAL=$(cat roast-*.json | jq -s 'map(.summary.critical_count) | add')
          if [ "$CRITICAL" -gt 0 ]; then
            echo "❌ Found $CRITICAL critical issues"
            exit 1
          fi

vs Alternatives

| Tool | What it does | Vibe | |------|-------------|------| | ESLint | Rule-based linting | 🤖 "Line 12: missing semicolon" | | SonarQube | Enterprise code quality | 📊 47-page PDF | | CodeRabbit | AI PR review | 🐰 Polite suggestions | | roast | AI code roasting | 🔥 "This code is DISGUSTING!" |

roast isn't a replacement for your linter. It's the brutal honesty your linter is too polite to give you. Use both.

FAQ

Q: Does it actually help?
A: Yes. Every roast contains real, actionable feedback. The humor makes you actually read it.

Q: Will it hurt my feelings?
A: Use --level mild if you're emotionally fragile. No judgment. Actually, a little judgment.

Q: How much does it cost?
A: ~$0.001 per roast with gpt-4o-mini. Mass roasting your entire codebase costs less than a coffee.

Q: Can I use it with Ollama / local models?
A: Set OPENAI_BASE_URL to your local endpoint. Works with any OpenAI-compatible API.

Featured On

Read the launch article on Dev.to: 4 CLI Tools Every Developer Needs (That You've Never Heard Of)

Also From MUIN

Love roast? Check out our other developer CLI tools:

• git-why — AI-powered git history explainer. roast tells you what's wrong; git-why tells you why it got that way.
• oops-ai — Pipe any error to AI for instant fixes. When roast hurts your feelings and you break something, oops picks up the pieces.
• portguard — Monitor and kill zombie processes hogging your ports. Because roasted code still needs to run somewhere.

Contributing

Found a bug? Want a new roast persona? PRs welcome.

git clone https://github.com/muin-company/cli-tools.git
cd cli-tools/packages/roast
npm install
node src/cli.js examples/bad.js

License

MIT © MUIN

Built by MUIN — AI가 일하고, 인간이 누린다.

🔥 Stop writing bad code. Or don't — we'll roast it either way.