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.1.0.tar.gz (255.5 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.1.0-py3-none-any.whl (316.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for clouvel-5.1.0.tar.gz
Algorithm Hash digest
SHA256 b327e3ad98ab7aca42ed32104c213afb9508abfa928c93b75a5567aca58b36e4
MD5 80a0e6aa84052188e0ac068f2548e5ce
BLAKE2b-256 1b6924b3d8e6e98efdecfa9bc3dc63706d3b39350ebc1d8b171e6590eb242e49

See more details on using hashes here.

File details

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

File metadata

  • Download URL: clouvel-5.1.0-py3-none-any.whl
  • Upload date:
  • Size: 316.7 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f29129044ebfb84300552b9deda4dd626450930bdf6e5cac819acb558cbe59c7
MD5 04bb15d41b112b066b26e403cb758e35
BLAKE2b-256 8b9a5b541ffaf6e6ab5cafe5fd85d670100e0f0878dc4854e9c24f1e01df0ab4

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