CERVEAU_SKIP_BINARY_UPDATE env var — set to 1 to skip CLI binary download during cerveau update (packages and configs are still updated).

gosec G104 — properly discard os.Remove errors in self-update cleanup paths.

Binary self-update — cerveau update now downloads and replaces the CLI binary from the latest GitHub release, in addition to updating packages and configs.

Core v2.0.0 hook permissions — hook scripts were missing execute bit, causing PostToolUse:Edit hook error in brains using core v2.0.0.

Documentation updated to remove all commit-validator references and reflect 80% handoff threshold.

core v2.0.0 — lowered context handoff threshold from 90% to 80%, removed commit-validator hook.

core-local v2.0.0 — same changes as core v2.0.0 for the offline variant.

Pre-commit hook templates — pre-commit-go.sh and pre-commit-deno.sh in _templates_/.

Marketplace versioning — registry supports multiple versions of the same package side by side.

Version via ldflags — binary version is now embedded at build time, version.txt removed.

SKIP_MDPLANNER install option — install without mdplanner dependency for core-local setups.

github package — pre-push-ci.sh hook removed (Claude hooks intercepting git commands are unreliable).

commit-validator hook — removed from core v2.0.0 and core-local v2.0.0 for the same reason.

version.txt — replaced by ldflags-based versioning.

.claude/ directory added to .gitignore.

File permissions restored to 644 for non-executable files.

cerveau boot <name> — launch Claude Code inside a brain from anywhere. Passes extra args through (e.g. cerveau boot MyApp --resume).

cerveau dir brain|code <name> — print the absolute path to a brain or its codebase directory. Pipe-friendly, single-line output.

cerveau cd brain|code <name> — navigate to brain or codebase directory via shell wrapper.

cerveau completion zsh|bash — shell completion scripts with tab-tab support for commands, brain names, packages, tags, and orgs. Includes the shell wrapper for cerveau cd.

cerveau marketplace list filters — filter packages by free text, --tag, or --org (case-insensitive). Example: cerveau marketplace list --org _local_.

cerveau backup [flags] — create a backup archive of ~/.cerveau/, ~/.claude/, and/or MDPlanner data. Flags: --all (default), --cerveau, --mdplanner, --claude, -o <path>.

cerveau restore <archive> [flags] — restore from a backup archive with confirmation prompt. Selective restore via --cerveau, --mdplanner, --claude.

cerveau spawn output now recommends cerveau boot instead of cd && claude.

install.sh reworked: extracts to /tmp, copies only runtime files to ~/.cerveau/, cleans up staging on exit.

cerveau update reworked: allowlist-based — only runtime files are updated, user data (_brains_/, data/, _packages_/_local_/, .env, brains.json) is never touched.

Non-runtime files (cmd/, docs/, go.mod, install.sh, LICENSE, README.md) are no longer copied to ~/.cerveau/.

Documentation updated: quick-start, first-brain, CLI reference, marketplace, and landing page all use cerveau boot as the primary launch method.

Disabled stop-progress-check.sh (Stop event) in settings.json.template and all brains — the hook blocked session exit to prompt a progress note, which proved disruptive in practice. Phase 4 Close rules still instruct Claude to write a [progress] note at session end.

Multi-brain system with selective rule loading

Six enforcement hooks (session-context, checkpoint-counter, post-edit-reminder, commit-validator, pre-compact-handoff, stop-progress-check)

MDPlanner integration via MCP (Streamable HTTP transport)

make spawn — creates new brains from templates

rebuild-brain-rules.sh — selective symlinks from brains.json

Core rules: code-discipline.md, goal-discipline.md

Workflow rules: local-dev.md, mdplanner-tasks.md

Brain CLAUDE.md with 4-phase session protocol

.claude/CLAUDE.md with mandatory gates and routing table

Docker Compose setup for MDPlanner

ARCHITECTURE.md, README.md, SETUP.md