Documentation

Learn how to use ClaudeBoost

Everything you need to install, configure, and get the most out of ClaudeBoost in your Claude Code workflow.

Getting Started

ClaudeBoost is a free MCP (Model Context Protocol) plugin for Claude Code that automatically enhances your prompts before they reach Claude. Install it in 30 seconds.

Step 1: Install & configure (regular terminal)

Terminal
pip install claudeboost-mcp
claudeboost-mcp --setup

Setup asks for your Anthropic API key, installs slash commands, and offers to sign in (for dashboard sync).

Step 2: Register MCP server (inside Claude Code)

Open Claude Code and type:

Claude Code
/boost --setup

This registers the MCP server. You only need to do this once. Restart Claude Code after this step.

Step 3: Start using it

That's it. Auto-boost is on by default — every task prompt you type is automatically enhanced. You don't need to type /boost every time, just type normally.

Claude Code
> build me a REST API for user management
# ⚡ CLAUDEBOOST · general_coding · Score: 8/30 → 22/30 (+14)
# 🔧 Boost added: tests & success criteria, organized sections
# Choose: Use boosted / Add notes / Keep original

How It Works

When you type a prompt in Claude Code, ClaudeBoost intercepts it and runs a 4-step pipeline before Claude sees your instruction:

1

Score

Your prompt is scored across 6 dimensions (Specificity, Verification, Context, Constraints, Structure, Output). If it scores 20+/30, ClaudeBoost skips the boost — your prompt is already well-structured.

2

Classify

Claude Haiku classifies your prompt into one of 7 domains (data science, DevOps, general coding, etc.) to apply domain-specific enhancement rules.

3

Enhance

The weakest scoring dimensions are identified and targeted. Light/medium boosts use Haiku (~3s), full boosts use Sonnet (~12s). Your past feedback and domain constraints are injected.

4

Present

You see the original vs boosted prompt with scores, what was added, and a breakdown by dimension. Choose to use the boost, add notes to refine it, or keep your original.

Commands

ClaudeBoost adds several slash commands and modifiers to Claude Code:

Terminal Commands

Run these in your regular terminal (outside Claude Code):

CommandDescription
claudeboost-mcp --setupSet up API key, install skills, and sign in
claudeboost-mcp --loginSign in (email + password in terminal)
claudeboost-mcp --logoutSign out
claudeboost-mcp --statusShow connected account
claudeboost-mcp --checkQuick version/config consistency check
claudeboost-mcp --doctorFull diagnostics (checks all 9 systems)
claudeboost-mcp --versionShow installed version

Claude Code Commands

Run these inside Claude Code:

CommandDescription
Just type normallyAuto-boosts every task prompt (when auto-boost is on)
/boost <prompt>Manually boost a specific prompt with the full comparison UI
/boost --setupRegister the MCP server (run once inside Claude Code)
/boost --loginSign in to ClaudeBoost (runs terminal login)
/boost --logoutSign out of ClaudeBoost
/boost --statusShow connected account and sync state
/boost-settingsView current boost settings (level and auto-boost status)
/boost-settings --level <light|medium|full>Change boost intensity. Short flag: -l
/boost-settings --auto <true|false>Toggle automatic prompt boosting. Short flag: -a
/boost-helpShow all available commands and usage guide
<prompt> --rawSkip auto-boost for that single prompt

Examples

Claude Code
# First time only — register the MCP server
> /boost --setup
✅ MCP server registered. Restart Claude Code to activate.

# After restart, auto-boost is on — just type normally
> build me an API endpoint for user auth
⚡ CLAUDEBOOST · general_coding · Score: 8/30 → 22/30 (+14)
🔧 Boost added: tests & success criteria, organized sections

# Skip boost for one prompt
> fix this typo in readme.md --raw

# Sign in (email + password in terminal)
> /boost --login

# Check which account is connected
> /boost --status

# Change boost level
> /boost-settings -l full

# Well-structured prompts skip automatically
> /boost fix the 403 error in src/auth/session.ts by adding token refresh
✅ Your prompt scores 22/30 — already well-structured!

Boost Levels

ClaudeBoost offers three intensity levels. Each targets a different quality score threshold:

Light

Level 3 · Haiku · ~2-3s

Fixes only dimensions scoring 1-2. Clarifies and structures your prompt while staying close to the original. Uses Haiku for speed.

Medium

Level 4 · Haiku · ~3-5s

Fixes dimensions below 3. Adds verification criteria, constraints, and structure. Fast and balanced — the default.

Full

Level 5 · Sonnet · ~10-15s

Pushes all 6 dimensions to maximum. Full enterprise playbook with anti-patterns, metrics, and acceptance criteria. Uses Sonnet for quality.

Domains

ClaudeBoost auto-classifies every prompt into one of 7 domains using Claude Haiku. Each domain has tailored enhancement rules:

DomainDescriptionExample Prompt
data_scienceML, statistics, data analysis, visualizationtrain a churn prediction model
data_engineeringETL, pipelines, databases, data infrastructurebuild a Spark pipeline for user events
business_analyticsReporting, dashboards, KPIs, business logiccreate a quarterly revenue dashboard
general_codingWeb dev, APIs, frontend, backend, debuggingbuild a REST API with auth
documentationDocs, READMEs, API specs, technical writingwrite API docs for the payment module
devopsCI/CD, infrastructure, Docker, deploymentset up GitHub Actions pipeline
otherAnything that doesn't fit the aboveorganize my desktop files

Scoring System

Every prompt is scored 1-5 on six dimensions, for a total of 6-30. Scoring is automated via text analysis — no API calls required.

DimensionWhat It MeasuresScore 1Score 5
SpecificityAre files, functions, and behaviors named?"fix the bug""fix the 403 error in src/auth/session.ts"
VerificationAre tests or success criteria defined?No mention of testing"Jest tests, >90% coverage, CI green"
ContextAre relevant files and patterns referenced?No file references"See src/auth/, follows existing OAuth pattern"
ConstraintsAre boundaries and non-goals stated?No limits given"Don't break SSO flow, no new deps"
StructureIs it organized with sections/steps?Single run-on sentenceNumbered steps with clear sections
OutputAre deliverables and formats specified?No output described"Single PR with migration + tests + docs"

Quality Levels

LevelAverage ScoreLabel
L1< 1.5Unacceptable — too vague to act on
L21.5 - 2.4Needs Work — missing key dimensions
L32.5 - 3.4Acceptable — clear enough for most tasks
L43.5 - 4.4Production — well-structured with constraints
L54.5+Enterprise — comprehensive, auditable prompt

Feedback & RLHF

ClaudeBoost learns from your preferences through a feedback loop inspired by Reinforcement Learning from Human Feedback (RLHF).

You write a prompt

ClaudeBoost enhances it

You rate & give feedback

🧠

Next boost improves

When you rate a boost (1-5 stars) or leave text feedback, it's stored in~/.claudeboost/history.json. Next time ClaudeBoost enhances a prompt in the same domain, it loads your last 5 feedback entries + your domain constraints and injects them into the enhancement prompt. The more feedback you give, the more personalized your boosts become.

Constraints

Domain constraints are persistent rules that ClaudeBoost always applies when enhancing prompts in a specific domain. Set them in the Dashboard under Constraints, or via the CLI settings.

Quick Presets

The Dashboard includes 12 one-click presets for common stacks: Python Data Science, PyTorch ML, dbt+BigQuery, Spark Pipeline, React+TypeScript, Next.js App Router, FastAPI, AWS+Terraform, Docker+Kubernetes, GitHub Actions CI/CD, API Documentation, and Executive Reports. Click one to fill in the domain constraints instantly.

Custom Constraints

Data Science

"Always use Python 3.11+. Prefer scikit-learn over custom implementations. Output as Jupyter notebooks."

General Coding

"Use TypeScript strict mode. Prefer Zod for validation. Follow existing project patterns."

DevOps

"Use GitHub Actions, not Jenkins. All Docker images must be multi-stage. No hardcoded secrets."

Documentation

"Use OpenAPI 3.1 for API docs. Include curl examples. Write for junior developers."

Dashboard

ClaudeBoost includes a web dashboard with authentication. Sign up at the landing page and your data syncs between CLI and web. The dashboard auto-refreshes every 5 seconds.

Pages

History

/org/new

Browse all boosted prompts. Filter by domain or quality level. Expand cards to see original vs boosted, score breakdown, and leave feedback.

Stats

/dashboard/stats

Analytics dashboard with boost acceptance rate, domain distribution, average ratings, 6-dimension score histograms, ROI metrics, feedback coverage, and daily activity.

Constraints

/dashboard/constraints

Configure boost level, toggle auto-boost, choose from 12 quick presets for common stacks, and set custom per-domain constraint rules.

Running the Dashboard

Terminal
cd web-dashboard
npm install
npm run dev
# Dashboard available at https://claudeboost.vercel.app

FAQ

Does ClaudeBoost modify my prompt before Claude sees it?

Yes. When auto-boost is on, ClaudeBoost rewrites your prompt and shows you the comparison. You choose whether to use the boosted version, refine it, or keep your original. You're always in control.

What happens when the MCP server isn't running?

Claude Code works normally without ClaudeBoost. Your prompts go directly to Claude without enhancement. You'll see a message that the MCP server is not connected.

Where is my data stored?

If signed in, data syncs to Supabase (our cloud database) so you can access it from the web dashboard and across devices. If not signed in, everything is stored locally in ~/.claudeboost/ as JSON files. Prompt text goes to the Anthropic API for enhancement.

Can I use ClaudeBoost with other AI tools?

ClaudeBoost is designed specifically for Claude Code via the MCP protocol. It hooks directly into the Claude Code CLI workflow.

What models does ClaudeBoost use?

Claude Haiku 4.5 for classification and light/medium enhancement (~2-5s). Claude Sonnet 4 for full-level enhancement (~10-15s). You provide your own Anthropic API key.

How do I install it?

Three steps: (1) pip install claudeboost-mcp in your terminal, (2) claudeboost-mcp --setup to configure API key and sign in, (3) /boost --setup inside Claude Code to register the MCP server. Restart Claude Code and you're done.

Do I need to type /boost every time?

No. Auto-boost is on by default — just type your prompt normally and it gets enhanced automatically. Use /boost only when you want to manually boost a specific prompt.

What if my prompt is already good?

ClaudeBoost skips prompts that score 20+/30 automatically. You'll see '✅ Your prompt is already well-structured!' and it proceeds without boosting.

Can I disable ClaudeBoost temporarily?

Use /boost-settings --auto false to turn off auto-boost. You can still manually boost with /boost <prompt>. Or append --raw to any prompt to skip just that one.

Something isn't working after upgrading. What do I do?

Run claudeboost-mcp --check in your terminal. It detects version mismatches, stale skills, and missing config. The fix is almost always: claudeboost-mcp --setup (to re-install skills matching your new version). For full diagnostics: claudeboost-mcp --doctor.

MCP server says 'not connected' even after setup

The MCP server must be registered inside Claude Code. Open Claude Code and type: /boost --setup. This runs 'claude mcp add' which always works from inside Claude Code. Then restart Claude Code.