🔥 RoastCode

Because your code deserves tough love (and some laughs).

A CLI tool that humorously roasts your code files, commit messages, and diffs with AI-powered savagery. Perfect for code reviews, team bonding, and keeping your codebase honest.

🎭 See it in Action

$ npx roastcode examples/bad-code.js
🔥 Roasting: examples/bad-code.js
Mode: SAVAGE
Engine: STATIC

🎯 Roast:
🤖 RoastBot: I've seen better code written by a cat walking on a keyboard.

$ npx roastcode examples/terrible-code.js --mode toxic
🔥 Roasting: examples/terrible-code.js
Mode: TOXIC
Engine: STATIC

🎯 Roast:
🤖 RoastBot: This code is what happens when you let a monkey write software.

🎯 What Makes RoastCode Unique

• 🎭 Multi-Mode Roasting: Choose your intensity - Gentle, Savage, or Toxic
• 🤖 Multiple AI Engines: Static (zero setup), OpenAI (cloud AI), or Ollama (local AI)
• 🎨 Meme Generation: Create hilarious memes based on your code issues
• 🔧 Git Integration: Roast commits, staged changes, and diffs
• 🧠 Smart Analysis: Detects console.log spam, nested ifs, magic numbers, and more
• ⚙️ Zero Configuration: Works out of the box with npx roastcode <file>
• 🔄 Graceful Fallback: AI engines fail? Falls back to static roasts automatically
• 🚀 CI/CD Ready: Perfect for GitHub Actions and automated code reviews

🚀 Quick Start - Zero Setup Required!

Installation (Choose One)

# Option 1: Use npx (recommended - no installation needed!)
npx roastcode [file]

# Option 2: Install globally
npm install -g roastcode

Basic Usage - Works Out of the Box!

# 🎯 Roast any file instantly (no setup required!)
npx roastcode index.js

# 🎭 Choose your roast intensity
npx roastcode index.js --mode gentle    # Playful hints
npx roastcode index.js --mode savage    # Brutal honesty (default)
npx roastcode index.js --mode toxic     # Unfiltered chaos

# 🤖 Use AI-powered roasting (requires setup)
npx roastcode index.js --engine openai  # Cloud AI
npx roastcode index.js --engine ollama  # Local AI

# 🔧 Git integration
npx roastcode --commit                  # Roast latest commit
npx roastcode --staged                  # Roast staged changes

# 🎨 Generate hilarious memes
npx roastcode index.js --meme

# 📋 See what's available
npx roastcode engines

🎭 Roast Modes

Gentle Mode

Playful hints and constructive criticism:

🤖 RoastBot: This code could use some love. And maybe some refactoring.

Savage Mode (Default)

Brutal but fair roasts:

🤖 RoastBot: This code is a masterpiece... of chaos.

Toxic Mode

Unfiltered chaos (use responsibly):

🤖 RoastBot: This code is what happens when you let a monkey write software.

🤖 AI Engines

Static Engine (Default)

• Zero setup required - works out of the box
• Pre-written roasts - consistent and reliable
• Perfect for CI/CD - no external dependencies

OpenAI Engine

• AI-powered roasts - contextual and creative
• Easy setup - just set your API key

Setup OpenAI

1. Get your API key from OpenAI
2. Set it as an environment variable:

   export OPENAI_API_KEY="sk-your-api-key-here"

3. Use it:

   npx roastcode index.js --engine openai

Ollama Engine

• Local AI - runs on your machine
• Privacy-focused - no data leaves your system
• Free to use - no API costs

Setup Ollama

1. Install Ollama from ollama.ai
2. Pull a model:

   ollama pull llama2

3. Use it:

   npx roastcode index.js --engine ollama --model llama2

🎭 Meme Generation

RoastCode can generate hilarious memes based on your code issues! Perfect for sharing on social media or team chats.

Basic Meme Generation

# Generate meme with static engine (default)
npx roastcode index.js --meme --mode savage

# Generate meme with AI-powered captions
npx roastcode index.js --engine openai --meme --mode savage

# Generate meme with local AI
npx roastcode index.js --engine ollama --meme --mode savage

# Different modes for memes
npx roastcode index.js --meme --mode gentle
npx roastcode index.js --meme --mode toxic

Available Meme Templates

RoastCode automatically selects the best meme template based on your code issues:

| Template | Description | Best For | |----------|-------------|----------| | drake | Drake Hotline Bling | Good vs Bad comparisons | | doge | Much wow, very doge | General humor and terrible code | | distracted-boyfriend | Distracted boyfriend | Choosing between options | | two-buttons | Two buttons meme | Decision making scenarios | | change-my-mind | Steven Crowder format | Controversial opinions | | one-does-not-simply | Boromir meme | Impossible tasks |

📖 Examples

Roasting Code Files

# Static engine (default)
$ npx roastcode examples/bad-code.js
🔥 Roasting: examples/bad-code.js
Mode: SAVAGE
Engine: STATIC

🤖 RoastBot: Console.log everywhere? Are you debugging or just lost?
🤖 RoastBot: These nested ifs are deeper than the Mariana Trench.
🤖 RoastBot: This function is doing everything except your laundry.

🎯 Overall Assessment:
🤖 RoastBot: This code is a masterpiece... of chaos.

# AI-powered roasting
$ npx roastcode examples/bad-code.js --engine openai
🔥 Roasting: examples/bad-code.js
Mode: SAVAGE
Engine: OPENAI

🎯 Roast:
🤖 RoastBot: Congratulations, you've successfully created the coding equivalent of a migraine—repetitive, pointless, and deeply confusing. The nested conditionals are so deep even a submarine would get claustrophobic, and your variable names are as inspiring as a toddler's grocery list.

Roasting Commits

$ npx roastcode --commit --engine openai
🔥 Roasting Commit: a43d2856
Mode: SAVAGE
Engine: OPENAI

📝 Commit Message:
"fixed bug lol"

🤖 RoastBot: Congratulations, your commit message is so informative it leaves future developers questioning if you were trying to write code or just invent a new form of hieroglyphics.

Meme Generation Examples

# Static engine meme (pre-written captions)
$ npx roastcode examples/bad-code.js --meme --mode savage
🔥 Roasting: examples/bad-code.js
Mode: SAVAGE
Engine: STATIC

🎯 Roast:
🤖 RoastBot: This code is a masterpiece... of chaos.

🎭 Generating Meme...
✅ Meme created: roast-meme-1234567890.png
   Template: drake
   Caption: "Use constants" / "Magic numbers everywhere"
   📁 Saved to: roast-meme-1234567890.png

# OpenAI AI-powered meme (dynamic captions)
$ npx roastcode examples/terrible-code.js --engine openai --meme --mode toxic
🔥 Roasting: examples/terrible-code.js
Mode: TOXIC
Engine: OPENAI

🎯 Roast:
🤖 RoastBot: Your code is so lazy, even a sloth would refuse to copy-paste those 10 console.logs.

🎭 Generating Meme...
✅ Meme created: roast-meme-1234567891.png
   Template: doge
   Caption: "Much TODOs" / "Very Lazy"
   📁 Saved to: roast-meme-1234567891.png

🔍 What Gets Roasted

The tool analyzes your code for:

• Console.log spam: Excessive debugging statements
• Nested ifs: Deeply nested conditional logic
• Long functions: Functions doing too much
• Magic numbers: Hardcoded numbers without context
• TODO comments: Procrastination markers
• Large files: Monolithic code files

⚙️ Configuration

Create a .roastmerc file in your project root:

{
  "mode": "savage",
  "targets": ["code", "commit"],
  "ci": false,
  "generateMeme": false,
  "ignorePatterns": [
    "node_modules/**",
    "dist/**",
    "build/**",
    ".git/**",
    "*.min.js",
    "*.bundle.js"
  ],
  "maxFileSize": 1000000,
  "enabledChecks": [
    "consoleLog",
    "nestedIfs",
    "longFunctions",
    "magicNumbers",
    "todoComments"
  ]
}

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | mode | string | "savage" | Roast intensity: gentle, savage, toxic | | targets | array | ["code", "commit"] | What to roast: code, commit, staged | | ci | boolean | false | CI mode (less verbose output) | | generateMeme | boolean | false | Generate meme with roast | | ignorePatterns | array | ["node_modules/**", ...] | Files to ignore | | maxFileSize | number | 1000000 | Maximum file size to analyze (bytes) | | enabledChecks | array | ["consoleLog", ...] | Which checks to run |

🔧 Git Integration

Git Hooks

Add to your .git/hooks/pre-commit:

#!/bin/sh
npx roastcode --staged --mode savage

GitHub Actions

Create .github/workflows/roast.yml:

name: Roast PR
on: [pull_request]

jobs:
  roast:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm install -g roastcode
      # Static engine (no API keys needed)
      - run: roastcode --staged --mode savage
      
      # Or with AI and memes (requires secrets)
      # - run: roastcode --staged --mode savage --engine openai --meme
      #   env:
      #     OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

🚀 Advanced Usage

CLI Options

# Engine selection
--engine static          # Static roasts (default)
--engine openai          # OpenAI AI-powered roasts
--engine ollama          # Local Ollama AI roasts

# Model selection (for AI engines)
--model gpt-4.1-nano      # OpenAI model (default)
--model llama2           # Ollama model (default)

# Mode selection
--mode gentle            # Playful criticism
--mode savage            # Brutal honesty
--mode toxic             # Unfiltered chaos

# Meme generation
--meme                   # Generate meme based on roast

# Git integration
--commit                 # Roast latest commit
--staged                 # Roast staged changes

# Configuration
--config .roastmerc      # Custom config file

🛠️ Development

Local Development

# Clone and install
git clone <repo>
cd roastcode
npm install

# Make executable
chmod +x bin/roastme.js

# Run locally
./bin/roastme.js index.js

# Test with AI engines
./bin/roastme.js examples/terrible-code.js --engine openai
./bin/roastme.js examples/terrible-code.js --engine ollama

Project Structure

roastcode/
├── bin/
│   └── roastme.js          # CLI entry point
├── lib/
│   ├── roaster.js          # Main roasting logic
│   ├── analyzer.js         # Code analysis
│   ├── git.js             # Git integration
│   ├── config.js          # Configuration handling
│   ├── adapter.js         # AI engine adapter
│   ├── prompts.js         # AI prompt templates
│   ├── meme-generator.js  # Meme generation functionality
│   ├── constants.js       # Constants and configurations
│   ├── static-prompts.js  # Static prompt templates
│   ├── utils.js           # Utility functions
│   └── engines/
│       ├── static.js      # Static roast engine
│       ├── openai.js      # OpenAI AI engine
│       └── ollama.js      # Ollama AI engine
├── examples/
│   ├── bad-code.js        # Sample bad code for testing
│   └── terrible-code.js   # Terrible code examples
├── .roastmerc             # Default config
├── .gitignore             # Git ignore patterns
├── package.json
└── README.md

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add your roasts or improvements
4. Test with the existing examples
5. Submit a pull request

Adding New Roasts

Static Roasts

Edit lib/engines/static.js and add new roast templates:

const roasts = {
  savage: [
    // ... existing roasts ...
    "Your new pattern is as welcome as a bug in production.",
    "This pattern is so bad it should come with a warning label."
  ]
}

AI Prompts

Edit lib/prompts.js to customize AI roasting behavior:

const prompts = {
  roast: (code, mode = "savage") => `
    // Customize the AI prompt template
    You are RoastBot, a legendary code critic...
  `
}

📄 License

MIT License - feel free to roast responsibly!

🙏 Acknowledgments

• Inspired by the countless hours spent reviewing code
• Built with love and a healthy dose of sarcasm
• Special thanks to all the console.log statements that made this possible
• Powered by AI engines that are as savage as they are smart

Remember: This tool is for fun and learning. Use it to improve your code, not to hurt feelings! 🎭

🔒 Privacy: Your code and API keys are handled securely. OpenAI API calls use industry-standard encryption, and Ollama runs entirely on your local machine.