Skip to main content

MCP server that remembers AI mistakes and prevents regressions - AI makes it fast, Clouvel makes it right

Project description

Clouvel

AI makes it fast. Clouvel makes it right.

PyPI Python License

Your AI remembers its mistakes. Regression Memory records every error and auto-warns before it happens again.

Try all Pro features free for 7 days — no credit card required. Run start_trial in Claude Code.


Demo


Why Clouvel?

AI coding is fast but forgetful:

The Pain What Actually Happens
AI repeats mistakes Fixed a bug yesterday, AI recreates it today
No one reviews your code Ship bugs you'd catch with a second pair of eyes
You forget past decisions "Why did we do it this way?" — no one remembers
Context resets every session New chat = new AI = same old mistakes

Free to act. Paid to remember.


What Clouvel Does

1. Memory — AI that learns from its mistakes

AI:  ⚠️ REGRESSION MATCH: This error happened before.
     Root cause: Missing null check on DB query result
     Prevention: Always validate query results before accessing properties
     (Memory #7 — hit 4 times, saved 3 bugs)

2. Feedback — 8 managers review in 30 seconds

👔 PM:  "User story covers happy path, but what about failed attempts?"
🛠️ CTO: "Consider rate limiting for brute force protection."
🔒 CSO: "⚠️ Password hashing not implemented."

3. Gate — Think before AI codes

You: "Build login"
AI:  ❌ BLOCKED - No PRD found. Write a spec first.

You: *writes PRD with requirements*
AI:  ✅ PASS - Ready to code.

Memory + Feedback + Gate = AI that gets smarter over time.


Quick Start

# Install
pip install clouvel

# Add to Claude Code (auto-detects your platform)
clouvel install
# If 'clouvel' is not recognized, use:
# py -m clouvel install        (Windows)
# python3 -m clouvel install   (Mac/Linux)

# Start coding - can_code check runs automatically
claude

That's it. No config needed.


FREE vs PRO

FREE PRO ($7.99/mo)
Projects 1 active (archive to switch) Unlimited
Templates lite + minimal All (lite + standard + detailed)
Managers 1 (PM only) 8 (PM, CTO, QA, CDO, CMO, CFO, CSO, Error)
Meeting 3 full meetings/month Unlimited
can_code WARN (doesn't block) BLOCK (enforces PRD)
Knowledge Base 7-day retention Persistent across sessions
Regression Memory - Records errors, auto-warns on repeat, monthly report
Error Learning - Learns from your mistakes
Execution Plan - plan with step-by-step actions

Want to try everything? Start a 7-day free trial — all Pro features, no credit card.

> start_trial
✅ 7-day Pro trial activated!

Get Pro →


Key Tools

Tool What it does FREE PRO
can_code Checks if you can start coding WARN BLOCK
start Project onboarding + PRD templates lite All templates
quick_perspectives Quick blind-spot check (3-4 managers)
manager C-Level review meeting PM only 8 managers
meeting Natural meeting transcript 3/month Unlimited
plan Detailed execution planning -
ship lint → test → build pipeline -
record_decision Save decisions to Knowledge Base -
error_learn Learn from mistakes -
memory_status Regression Memory dashboard -
memory_search Search past error patterns -
memory_report Monthly savings report -
memory_global_search Search memories across all projects -
set_project_domain Isolate memories by domain (personal/work/client) -
start_trial Activate 7-day Pro trial -

7 project types: web-app, api, cli, chrome-ext, discord-bot, landing-page, saas


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

# If 'clouvel' is not recognized:
py -m clouvel install        # Windows
python3 -m clouvel install   # Mac/Linux
Manual configuration

Windows:

{
  "mcpServers": {
    "clouvel": {
      "command": "py",
      "args": ["-m", "clouvel.server"]
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "clouvel": {
      "command": "python3",
      "args": ["-m", "clouvel.server"]
    }
  }
}

Usage Examples

Block coding without PRD

You: "Build a user authentication system"

Clouvel: ❌ BLOCKED
- PRD.md not found
- Architecture.md not found

💡 Write a PRD first. Use `start` to begin.

Start a new project

You: "Start a new project"

Clouvel: 🚀 Project detected: web-app

Questions:
1. What's the main goal?
2. Who are the users?
3. What are the core features?

→ Generates PRD from your answers

Get manager feedback (Pro)

You: "Review my login implementation"

👔 PM: User story covers happy path, but what about failed attempts?
🛠️ CTO: Consider rate limiting for brute force protection.
🧪 QA: Need tests for edge cases - empty password, SQL injection.
🔒 CSO: ⚠️ CRITICAL - Password hashing not implemented.

Status: NEEDS_REVISION

Links


License

MIT License - see LICENSE for details.


AI makes it fast. Clouvel makes it right.
WebsiteIssuesGet Pro

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-4.0.1.tar.gz (223.4 kB view details)

Uploaded Source

Built Distribution

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

clouvel-4.0.1-py3-none-any.whl (270.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for clouvel-4.0.1.tar.gz
Algorithm Hash digest
SHA256 9742ac2dcb82e1bd4eb158d3c8536ce51461fb517fbeb59ab2c25c94bf0e4345
MD5 41e66b9837f8e73082f85b1d2b453f4b
BLAKE2b-256 1075c172e2b2e2ffc0946281542f06150c71cd49106b9b8572cc3b87c0db84f5

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for clouvel-4.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 67a92113032edf623d679bc035e6938d3895b1508c33b09181ea8819724487f7
MD5 d258c9d9f523eafd0489f99eb84bd28b
BLAKE2b-256 3d9874106be3c0205fa0fd0659f73e48cfbaf7e8a7351a804311fd9b88e77ff7

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