MCP server that remembers AI mistakes and prevents regressions - AI makes it fast, Clouvel makes it right
Project description
Clouvel
Stop Claude Code from breaking your code.
Claude Code is fast. But it forgets what it broke yesterday and breaks it again today.
Clouvel remembers. It records every error, warns before repeats, and blocks coding without a spec.
The Problem
| What happens | Why it hurts |
|---|---|
| AI recreates a bug it fixed yesterday | No error memory between sessions |
| You ship without anyone reviewing | No second pair of eyes |
| "Why did we do it this way?" | Decisions lost when context resets |
| New session = same old mistakes | AI starts from zero every time |
What Clouvel Does
1. Error Memory — AI that learns from mistakes
AI: Warning: This error happened before.
Root cause: Missing null check on DB query result
Prevention: Always validate query results before accessing
(Memory #7 — prevented this bug 3 times)
2. Spec Gate — Think before AI codes
You: "Build login"
AI: BLOCKED - No PRD found. Write a spec first.
You: *writes PRD*
AI: PASS - Ready to code.
3. Quick Check — Blind spots in 10 seconds
PM: "What happens when login fails 5 times?"
CTO: "Rate limiting needed for brute force protection."
Quick Start
pip install clouvel
# Auto-configure for Claude Code / Claude Desktop / VS Code
clouvel install
# Start coding
claude
That's it. Clouvel runs automatically.
Tools
Free (10 tools — always available)
| Tool | What it does |
|---|---|
can_code |
Blocks coding without a spec |
start |
Set up a new project with PRD templates |
save_prd |
Save your PRD from conversation |
error_check |
Warns before repeating past mistakes |
error_record |
Records errors with root cause analysis |
context_save |
Saves working state before context runs out |
context_load |
Restores state in a new session |
quick_perspectives |
Quick blind-spot check (2 managers) |
gate |
Run lint, test, build in sequence |
license_status |
Check plan, activate license, start trial |
Pro (10 more tools — $7.99/mo)
| Tool | What it does |
|---|---|
error_learn |
Auto-generates NEVER/ALWAYS rules from error patterns |
memory_status |
Error memory dashboard with hit counts |
memory_search |
Search past errors by keyword |
memory_global_search |
Share error patterns across all projects |
drift_check |
Detects when work drifts from goals |
plan |
Detailed execution plans with dependencies |
meeting |
Full 8-manager C-Level review |
ship |
One-click lint+test+build with evidence |
record_decision |
Persistent knowledge base for decisions |
search_knowledge |
Search past decisions and context |
Free vs Pro
| Free | Pro ($7.99/mo) | |
|---|---|---|
| Error history | Last 5 errors | Full history + patterns |
| Context slots | 1 (overwrites) | 50 + timeline |
| Manager feedback | 2 managers, 1 question | 8 managers, 2+ questions |
| Error learning | - | Auto-generates rules |
| Cross-project memory | - | Share lessons everywhere |
| Drift detection | - | Catches scope creep |
| Ship pipeline | gate (basic) | Full verify + evidence |
Try Pro free for 7 days — no credit card:
> license_status(action="trial")
Installation
Requirements
- Python 3.10+
- Claude Code, Claude Desktop, or VS Code with Claude extension
Install
pip install clouvel
Connect to Claude
Automatic (recommended):
clouvel install
Manual configuration
Windows:
{
"mcpServers": {
"clouvel": {
"command": "py",
"args": ["-m", "clouvel.server"]
}
}
}
Mac/Linux:
{
"mcpServers": {
"clouvel": {
"command": "python3",
"args": ["-m", "clouvel.server"]
}
}
}
How It Works
Day 1: Install → start → write PRD → can_code PASS → code
Day 3: Error happens → error_record saves it
Day 5: Same file → error_check warns "this broke before"
Day 7: 5+ errors → "Full history available in Pro"
Day 10: Context runs out → context_save/load preserves everything
Day 14: Decide: $7.99/mo or stay Free
Links
License
MIT License - see LICENSE for details.
Stop Claude Code from breaking your code.
Issues
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file clouvel-5.2.0.tar.gz.
File metadata
- Download URL: clouvel-5.2.0.tar.gz
- Upload date:
- Size: 257.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5239efe11f46b456a178a5a141f20f89aa4aafcc3ff424bd38d2d56371c064f5
|
|
| MD5 |
8640b543e88118bd27999bc110033a23
|
|
| BLAKE2b-256 |
8835b2d3ec45fd4e6ac62a7f699b476f39faa10b46a69a5e101d697a767de7d6
|
File details
Details for the file clouvel-5.2.0-py3-none-any.whl.
File metadata
- Download URL: clouvel-5.2.0-py3-none-any.whl
- Upload date:
- Size: 321.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b52d1a63c43e31bd9d6d6d0428b9a4c1811b41ac8a3a74a5abc4dd16de78d88
|
|
| MD5 |
95f4a9007e2351af1b94e84f4966f098
|
|
| BLAKE2b-256 |
60abe9cd3e1f97b44796cded7b6f2d40e5a48eadff18675d8d6b498e32594ee1
|