Installation

Prerequisites

Install the following tools before starting:

python3 --version   # any version — used by Makefile path calculations
jq --version        # brew install jq  /  apt install jq
podman compose version

gh (GitHub CLI) is optional — needed for PR workflows only.

Clone

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

You should have:

cerveau.dev/
  _protocol_/       ← shared rules, hooks, templates (source of truth)
  _configs_/        ← brains.json registry
  _brains_/         ← created by make onboard (empty for now)
  _scripts_/        ← rebuild-brain-rules.sh, backup-claude.sh
  _projects_/       ← you can put your git submodules/clone here (or anywhere else)
  docker-compose.yml
  .env.example
  README.md

Shell Setup (Optional)

Add to your ~/.zshrc and reload:

alias claude='claude --verbose'

Install the status line:

cp cerveau.dev/_protocol_/statusline.sh ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

Next

→ Quick Start