An open API service indexing awesome lists of open source software.

https://github.com/studiowebux/cerveau.dev

Multi-brain protocol for Claude Code — one shared protocol, many projects, zero duplication. MDPlanner-driven workflow with selective rules, hooks, and agents per project.
https://github.com/studiowebux/cerveau.dev

agents ai-workflow brain-protocol claude-code developer-tools llm mdplanner vibe-coded

Last synced: 3 months ago
JSON representation

Multi-brain protocol for Claude Code — one shared protocol, many projects, zero duplication. MDPlanner-driven workflow with selective rules, hooks, and agents per project.

Awesome Lists containing this project

README

          

# Cerveau.dev

Multi-brain system for Claude Code. One protocol, many projects, zero
duplication.

Each project gets its own brain with selective rules, hooks, agents, and skills
loaded from a shared protocol. MDPlanner is the single source of truth for
tasks, notes, decisions, and progress.

Bug Tracker: https://github.com/studiowebux/cerveau.dev/issues


Discord: https://discord.gg/BG5Erm9fNv

## Features

| Feature | Description |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Multi-Brain** | One protocol, many projects. Each brain gets selective rules, hooks, and agents — no duplication, no drift. |
| **Selective Loading** | Declare exactly which stacks, practices, and workflows each brain needs. Only those rules load into context. |
| **MDPlanner Integration** | Single source of truth for tasks, notes, decisions, and progress. Claude reads and writes it every session. |
| **Hooks Enforcement** | Boot reminders, commit validation, checkpoint checks, and progress gates. The protocol runs automatically. |
| **Protocol-Driven Workflow** | Four phases. Boot → Work → Write Back → Close. Zero drift between sessions. |
| **Zero Footprint** | No files added to your project repos. The brain lives outside your code. Your codebase stays clean. |
| **Bring Your Own Rules** | No rules ship by default. Generate stack, practice, and workflow rules with a single Claude prompt. |
| **Marketplace** | Browse and install community packages (workflows, practices, agents) into any brain. Filter by text, tag, or org. |
| **Shell Completions** | Tab-tab support for all commands, brain names, packages, tags, and orgs. Includes `cerveau cd` shell wrapper. |
| **Boot from Anywhere** | `cerveau boot ` launches Claude Code in any brain from any directory. No `cd` needed. |
| **Backup & Restore** | `cerveau backup` archives `~/.cerveau/`, `~/.claude/`, and MDPlanner data. Selective scope with flags. |
| **Open Source** | AGPL-3.0. Self-host everything. MDPlanner runs in a container. No external dependencies required. |
| **Agent Support** | Define custom agents in YAML. Declare which agents each brain loads. Agents live in the protocol. |
| **Skills Support** | Reusable skill definitions (slash commands) shared across all brains from the protocol. |

## Quick Start

```bash
curl -fsSL https://cerveau.dev/install.sh | bash # install
cerveau spawn MyApp /path/to/myapp # create a brain
cerveau boot MyApp # launch Claude Code

# Optional: enable tab-tab
eval "$(cerveau completion zsh)" # add to .zshrc
```

## Documentation

Full documentation at **https://cerveau.dev** — installation, quick start, guides, and reference.

## License

AGPL-3.0