Makefile Targets

Last updated: March 12, 2026

Makefile Targets

All targets run from cerveau.dev/_protocol_/:

cd cerveau.dev/_protocol_
make help

Targets

onboard

Spawn + connect MCP + rebuild rules in one step. The fastest path to a working brain.

make onboard NAME=MyApp PROJECT=/absolute/path/to/your/code

Runs spawn, then rebuild-brain-rules.sh, then claude mcp add automatically.
Use this for new brains. Use spawn + manual steps if you need more control.

spawn

Create a new brain and wire .claude into it.

make spawn NAME=MyApp PROJECT=/absolute/path/to/your/code
  • NAME — brain name (creates _brains_/myapp-brain/)
  • PROJECT — absolute path to your code repo

What it does:

  • Creates _brains_/myapp-brain/ with all templates
  • Replaces __PROJECT__ placeholders with NAME
  • Creates selective symlinks for rules, agents, hooks
  • Generates settings.json with additionalDirectories pointing to PROJECT
  • Adds an entry to _configs_/brains.json

install

Install the status line script to ~/.claude/statusline.sh.

make install

Copies _protocol_/statusline.sh and makes it executable. Run once after cloning.

status

Show install status for a brain.

make status NAME=MyApp

Reports: symlink status for rules/hooks/agents, settings.json validity,
presence of CLAUDE.md files.

list

List all existing brains.

make list

Scans _brains_/ and prints all *-brain directories with their paths.

validate

Check a brain has no remaining __PROJECT__ placeholders.

make validate NAME=MyApp
# expected: OK: No __PROJECT__ placeholders found

Run this after make spawn to confirm the template was fully substituted.

diff

Show what changed between the protocol template and a brain.

make diff NAME=MyApp

Useful for reviewing customizations made to a brain after spawning.

sync-shareable

Copy changed protocol files to _shareable_/. Only updates files that differ.

make sync-shareable

Run this from the monorepo _protocol_/ (not from _shareable_/_protocol_/).
Then cd _shareable_ and commit + push to GitHub.

help

Print all available targets with descriptions.

make help

Workflow

# Fast path — all in one
make onboard NAME=MyApp PROJECT=/path/to/myapp

# Manual path — step by step
make spawn NAME=MyApp PROJECT=/path/to/myapp
cd ../_brains_/myapp-brain && claude mcp add --transport http mdplanner \
  http://localhost:8003/mcp --header "Authorization: Bearer <token>"
cd cerveau.dev && ./_scripts_/rebuild-brain-rules.sh MyApp
cd _brains_/myapp-brain && claude