Install

The Cerebrumma installer sets up everything in one shot: the cerebrum CLI, the Python MCP server, and Claude Code integration. Rust and uv are installed automatically if missing.

One-liner #

Run this in your terminal:

bash

$ curl -fsSL http://get.cerebrumma.com | sh

bash

$ curl -fsSL http://get.cerebrumma.com | sh
  Cerebrumma — Portable, git-tracked AI Brain  One Brain. Any Tool.
  ✓ Rust already installed  ✓ uv already installed  → Cloning Cerebrumma...  ✓ Cloned https://github.com/BenPeralta/cerebrumma  → Building cerebrum CLI (this takes ~30s on first run)...  ✓ cerebrum installed → ~/.cargo/bin/cerebrum  → Installing MCP server...  ✓ MCP server installed → ~/.cerebrumma/mcp_server  → Configuring Claude Code MCP integration...  ✓ Claude Code configured — restart Claude Code to load the Brain  → Initializing global Brain...  ✓ Global Brain created at ~/.cerebrum/
  Cerebrumma installed!
  Quickstart:    cerebrum add --global "your coding rules"    cerebrum status
  In any project:    cerebrum init            # local Brain for this repo    cerebrum hook install    # auto-capture git commits    cerebrum dream           # run a reflection cycle
  Restart Claude Code to activate the MCP Brain tools.

This will:

Install Rust (via rustup) if not already present
Install uv (Python package manager) if not already present
Clone the Cerebrumma repo and build the cerebrum binary
Copy the MCP server to ~/.cerebrumma/mcp_server/
Auto-configure Claude Code via claude mcp add (writes to ~/.claude.json)
Initialize your global Brain at ~/.cerebrum/

Requirements #

macOS or Linux
git installed
curl installed
Internet connection (for cloning and downloading dependencies)

What gets installed #

After installation, you'll have:

text

~/.cargo/bin/cerebrum       # the CLI binary
~/.cerebrumma/mcp_server/  # the MCP server
~/.cerebrum/               # your global Brain
~/.claude/settings.json    # patched with MCP config

Manual MCP setup #

If the auto-config didn't work (e.g., Claude Code wasn't installed yet), run this after installing Claude Code:

bash

claude mcp add cerebrumma -s user ~/.cerebrumma/run-mcp.sh

This writes to ~/.claude.json and takes effect after restarting Claude Code. Verify with /mcp — you should see Cerebrumma MCP Server · ✔ connected.

Verify the install #

bash

$ cerebrum status
Brain ~/.cerebrum/ (global)   Working                → 0   Episodic               → 5   Semantic               → 0   Skills                 → 0   Protocols              → 0   Personal / Equity      → 0
   Use cerebrum add "..." to grow it.

You should see entry counts for your global Brain. If you see an error, make sure ~/.cargo/bin is in your PATH:

bash

$ export PATH="$HOME/.cargo/bin:$PATH"

Uninstall #

To remove everything Cerebrumma installed, run these commands in order. Step 3 deletes your Brain — skip it if you want to keep your memories and just reinstall the tooling.

bash

# 1. Remove the CLI binary
rm -f ~/.cargo/bin/cerebrum

# 2. Remove the MCP server
rm -rf ~/.cerebrumma

# 3. Remove your global Brain (skip to keep your memories)
rm -rf ~/.cerebrum

# 4. Remove Cerebrumma from Claude Code
claude mcp remove cerebrumma -s user

Then restart Claude Code to drop the MCP connection. You can reinstall fresh at any time with the one-liner above.

Quickstart→