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.


All Tools (20)

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
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
context_save Saves working state before context runs out
context_load Restores state in a new session
quick_perspectives Quick blind-spot check from managers
meeting Full 8-manager C-Level review
drift_check Detects when work drifts from goals
plan Detailed execution plans with dependencies
gate Run lint, test, build in sequence
ship One-click lint+test+build with evidence
record_decision Persistent knowledge base for decisions
search_knowledge Search past decisions and context
license_status Check Clouvel status

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:  error_learn auto-generates NEVER/ALWAYS rules
Day 10: Context runs out → context_save/load preserves everything
Day 14: Cross-project memory shares lessons across repos

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-6.2.0.tar.gz (358.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-6.2.0-py3-none-any.whl (445.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for clouvel-6.2.0.tar.gz
Algorithm Hash digest
SHA256 4e7677730f0fb2131cbd51e54d09319590f65a761ff240f3014b43fea3ecf494
MD5 892ddc0266b0335013197d6cbf79adfe
BLAKE2b-256 0fe1b9ac1d6b696e9b295d2f7ea5abbccf604b20799b893069fbb6e42d90840f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: clouvel-6.2.0-py3-none-any.whl
  • Upload date:
  • Size: 445.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for clouvel-6.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 34b4c68d36cb2ff7b034162bd0332bb4f2cf3fd06619f5c4db32e6b82581698f
MD5 c97c0a580668137bcffed65978a53761
BLAKE2b-256 b00c06d8972103cfd003fb0d18bd5f0461c8a96e6a927ea202de1c57f4ef3286

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