Install

The Cerebrumma installer sets up everything in one shot: the cerebrum CLI, the Python MCP server, and Claude Code integration. It downloads a prebuilt binary for your platform — no compiler needed — and installs uv automatically for the MCP server.

One-liner #

Run this in your terminal:

bash

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

Homebrew #

Prefer Homebrew? The tap installs the same prebuilt cerebrum binary:

bash

$ brew install BenPeralta/cerebrumma/cerebrumma

Homebrew installs the CLI only. To also set up the MCP server and auto-configure Claude Code, run the one-liner above afterward (or the claude mcp add command below).

bash

$ curl -fsSL https://get.cerebrumma.com | sh
  Cerebrumma — Portable, git-tracked AI Brain  One Brain. Any Tool.
  → Downloading cerebrum (aarch64-apple-darwin)...  ✓ cerebrum installed → ~/.local/bin/cerebrum  ✓ uv already installed  → 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 map --graph     # see your Brain as a neural map
  Restart Claude Code to activate the MCP Brain tools.

This will:

Download the prebuilt cerebrum binary for your platform to ~/.local/bin/ (falls back to building from source only if your platform has no prebuilt binary)
Install uv (Python package manager) if not already present
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 (Apple Silicon or Intel) or Linux (x86_64)
curl installed
git installed (used to fetch the MCP server)
Internet connection (to download the binary)

What gets installed #

After installation, you'll have:

text

~/.local/bin/cerebrum      # the CLI binary
~/.cerebrumma/mcp_server/  # the MCP server
~/.cerebrum/               # your global Brain
~/.claude.json             # MCP config (via claude mcp add)

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 ~/.local/bin is in your PATH:

bash

$ export PATH="$HOME/.local/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 ~/.local/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→