roastmaster

🔥 RoastMaster

"The only code reviewer that hates you."

RoastMaster is an AI agent that reviews your code, finds bugs, and ROASTS you for them. It can also fix your code, but it will leave passive-aggressive comments in the PR.

🚀 Why?

Because code reviews are boring. You need to be humbled.

📦 Installation

git clone https://github.com/vamgan/roastmaster.git
cd roastmaster
npm install
npm run build
npm link

🌶️ Usage

1. The Roast (roast)

Analyzes your file and destroys your ego.

roast src/broken.ts
# Output: "Bro really tried to use `any` in 2025? 💀 Expected better from you chief."

2. The Fix (fix)

Fixes the code, but adds helpful comments like // fixing this race condition fr fr.

fix src/broken.ts

3. Change Persona (--persona)

• roast: The default. Ruthless Gen Z.
• hype: Overwhelmingly positive. "KING YOU DROPPED THIS 👑"
• senior: "Back in my day we wrote C on napkins."

roast src/index.ts --persona hype

Configuration via .mcp.json

The project includes a .mcp.json file that automatically registers the MCP server when loaded as a plugin. Ensure your OPENAI_API_KEY is set in your environment.

{
  "mcpServers": {
    "roastmaster": {
      "command": "npx",
      "args": ["-y", "roastmaster@latest", "server"],
      "env": {
        "OPENAI_API_KEY": "your-key-here"
      }
    }
  }
}

That's it. No git clone, no setup. Just add those 6 lines and Claude gains the power of roasting.

🤝 Contributing

Don't break it or I'll roast your PR.

Installation (Claude Desktop / MCP)

You can use RoastMaster as a tool within Claude Desktop.

Prerequisites

1. Node.js (v18 or higher)
2. Git

Configuration

Add the following to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "roastmaster": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/roastmaster/dist/server.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here",
        "BEDROCK_MODEL_ID": "optional-bedrock-model-id" 
      }
    }
  }
}

Note: You must clone this repository and build it (npm install && npm run build) locally for the path to exist.

Using via GitHub (npx)

If you don't want to clone, you can use npx directly (once published to npm) or point to the repo if configured:

Using as a Claude Plugin (Claude Code)

RoastMaster is designed to work as a native Claude Code plugin. It provides the following commands:

• /roast: Reviews your code with ruthlessness.
• /fix: Attempts to fix your code (with attitude).

To install in Claude Code:

1. Register the marketplace:

/plugin marketplace add vamgan/roastmaster

2. Install the plugin:

/plugin install roastmaster@roastmaster-marketplace

3. Verify:

/roast src/index.ts