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

# 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 → Use code LAUNCH70 for 70% off annual ($23.99/yr)


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
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.0.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.0-py3-none-any.whl (270.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clouvel-4.0.0.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.0.tar.gz
Algorithm Hash digest
SHA256 f2dd7ad1223987d879ffd7a71b03e42a4b990bbf7951a1843769c3e8cb413b97
MD5 783e441e56677546457c3d3e9b3b67a2
BLAKE2b-256 24fa5075964f545f58353624aeab7f6eba5008bf615a21e7ac08489ff2c752e2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: clouvel-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 270.2 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f70b9f184518674d7b3168357108cb378b9fd4a32e382b4de083ede27ca2806c
MD5 3e06e3fa8da42120f4bca07b3331c8f4
BLAKE2b-256 a10a6e755e91e8982d7b6fe0c4c28a3c414e8283f67672197cf4044d907cd927

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