Roast My Design System
Scans a UI repo for design-system gaps and serves on-system rules to coding agents
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 10.2.4
- Listing updated
- 3 days ago
About Roast My Design System
Roast My Design System is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
The premise comes from the author's own tests: an agent copies what it finds in a repo and invents where there is nothing to copy. The tool runs at the root of a UI repo with npx, opens a report within about a second and, per the README, needs no account, no network and no telemetry and changes nothing in the repo.
The report names where an agent will have to guess, lists the mess it would copy ranked by what fixing it is worth with file paths and a copy-ready fix prompt, and gives a 0 to 100 health score that is the same every run. One measured gap is charts that hardcode colours in a repo without a chart palette; the README says 43 of 126 public repos look like that.
The approach is described as roast, teach and guard: find the real design system, generate rules for agent files and a local MCP server that answers questions, then check every edit through a plugin hook. In the author's tests across 10 open-source products and 355 agent sessions, an agent called the MCP tools in only 7 of 24 Sonnet sessions and 2 of 24 Haiku sessions, while the edit hook ran without being asked and showed the lowest counts of off-system findings. The project's site has moved to roastds.com.
Install
Run in a terminal
claude mcp add roast-my-design-system -- npx -y roast-my-design-systemAdd to claude_desktop_config.json
{
"mcpServers": {
"roast-my-design-system": {
"command": "npx",
"args": [
"-y",
"roast-my-design-system"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"roast-my-design-system": {
"command": "npx",
"args": [
"-y",
"roast-my-design-system"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"roast-my-design-system": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"roast-my-design-system"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"roast-my-design-system": {
"command": "npx",
"args": [
"-y",
"roast-my-design-system"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"roast-my-design-system": {
"command": "npx",
"args": [
"-y",
"roast-my-design-system"
]
}
}
}What it does
- Design-system scan
- Finds the real design system in a repo, the mess in it and the gaps.
- Guess map
- Shows where an agent will have to invent because the repo has no answer.
- Health score
- A 0 to 100 score that is stable between runs.
- Generated agent rules
- Writes rules into agent files so agents follow the system.
- Local MCP answers
- Serves design-system answers to agents on request.
- Edit guard
- A plugin hook checks every edit and can gate pull requests.
Good for
- See where an AI agent is likely to invent UI in your codebase
- Rank design-system clean-up work by value
- Give a coding agent rules that match your tokens and components
- Check agent edits against the system automatically
Pricing
Open source
Prices change. Check gregkozakiewicz.github.io before you buy.
Roast My Design System FAQ
How do I run it?
Run npx roast-my-design-system@latest at the root of a UI repo.
Does it send data anywhere?
The README says no account, no network and no telemetry, and nothing in your repo changes.
Do agents call the MCP tools reliably?
Not always. In the author's October tests Sonnet called them in 7 of 24 sessions and Haiku in 2 of 24, which is why an edit hook is provided.
What does the score mean?
A 0 to 100 health score for the repo's design system, the same on each run.
Is Roast My Design System free?
Yes. Roast My Design System is open source, so you can use and self-host it for free.
How do I add Roast My Design System to Claude Code?
Run this command in your terminal: claude mcp add roast-my-design-system -- npx -y roast-my-design-system
What are the best alternatives to Roast My Design System?
The closest alternatives to Roast My Design System are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Roast My Design System

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory