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.0.0.tar.gz (232.1 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.0.0-py3-none-any.whl (279.6 kB view details)

Uploaded Python 3

File details

Details for the file clouvel-5.0.0.tar.gz.

File metadata

  • Download URL: clouvel-5.0.0.tar.gz
  • Upload date:
  • Size: 232.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for clouvel-5.0.0.tar.gz
Algorithm Hash digest
SHA256 2bfe21540990e0915f7910fa9fcdf5cf809d1c8e96af43d49690f2023853312d
MD5 f0fc4c1637393306d40d3d9c02aba77d
BLAKE2b-256 5db7eba6e93c72d2b47590a2d757b542d000362aed5dd77838095536cd134c4e

See more details on using hashes here.

File details

Details for the file clouvel-5.0.0-py3-none-any.whl.

File metadata

  • Download URL: clouvel-5.0.0-py3-none-any.whl
  • Upload date:
  • Size: 279.6 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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5e80f104efce77131bf1d9bc4935cb887f72f85f53321af400a60c7af2de21b6
MD5 95e3e96d7019548efb32e4f38263bd8d
BLAKE2b-256 ab811b6f164dcf83623569c16fa70644659766e47772d56698cd54570075440f

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