Skip to main content

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.

PyPI Python License

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clouvel-5.2.0.tar.gz (257.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clouvel-5.2.0-py3-none-any.whl (321.9 kB view details)

Uploaded Python 3

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

Hashes for clouvel-5.2.0.tar.gz
Algorithm Hash digest
SHA256 5239efe11f46b456a178a5a141f20f89aa4aafcc3ff424bd38d2d56371c064f5
MD5 8640b543e88118bd27999bc110033a23
BLAKE2b-256 8835b2d3ec45fd4e6ac62a7f699b476f39faa10b46a69a5e101d697a767de7d6

See more details on using hashes here.

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

Hashes for clouvel-5.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8b52d1a63c43e31bd9d6d6d0428b9a4c1811b41ac8a3a74a5abc4dd16de78d88
MD5 95f4a9007e2351af1b94e84f4966f098
BLAKE2b-256 60abe9cd3e1f97b44796cded7b6f2d40e5a48eadff18675d8d6b498e32594ee1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page