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.

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

License

MIT License - see LICENSE for details.

Stop Claude Code from breaking your code.
Issues

Metadata

Release files for clouvel 6.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clouvel 6.2.1
File	Size	Uploaded
clouvel-6.2.1.tar.gz	357.1 kB	Mar 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for clouvel 6.2.1
File	Interpreter	ABI	Platform	Reset
clouvel-6.2.1-py3-none-any.whl 443.3 kB Mar 3, 2026	Python 3	none	any	Details

Total release size: 800.4 kB

Release files / clouvel-6.2.1.tar.gz

Download URL	clouvel-6.2.1.tar.gz
Size	357.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`9c53f6d7adfa995ee96fd67fe41ac8c4a0e75b1a02bc8d0c3dae772edcff6348`
BLAKE2b-256 checksum How to use checksums	`48ff72176b1457b835268d888eb562a97b5b2d5335c1eba6e2c4d472f5bafd7a`
Upload date	Mar 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`

Release files / clouvel-6.2.1-py3-none-any.whl

Download URL	clouvel-6.2.1-py3-none-any.whl
Size	443.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4d01f1539182fa973db2b234a53ad4fb62a37f39eaea64e4cdb5d61da0474c61`
BLAKE2b-256 checksum How to use checksums	`56913ea7084baca04d00bb12e246619cb0d553457c054420fcf7ccc7503a0b75`
Upload date	Mar 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`