Platform-agnostic CLI for managing portable AI agent brains.
Your AI agent has a brain — a folder of text files that define its personality, memory, skills, and instructions. brainpack makes it easy to version, sync, export, and move that brain across machines and platforms.
Works with OpenClaw, Cursor, Claude Code, Windsurf, Cline, Codex, Aider, GitHub Copilot, and 12 more platforms. If your agent's brain is a folder of files, brainpack can manage it.
npm install -g @mager/brainpackOr use directly:
npx @mager/brainpack init# Initialize your agent's brain directorycd~/.openclaw/workspace # or wherever your brain lives
brainpack init
# Push to remote (git commit + push in one command)
brainpack push
# On another machine, clone and pull
git clone git@github.com:you/my-brain.git ~/.openclaw/workspace
cd~/.openclaw/workspace
brainpack pull
# See what's changed
brainpack diff
# Snapshot before experiments
brainpack snapshot pre-experiment
# Export for offline transfer
brainpack export# Import on a new machine
brainpack import brainpack-export-2026-02-21.tar.gz
# Check what secrets need manual setup
brainpack secrets| Command | Description |
|---|---|
brainpack init | Initialize directory as a brainpack (auto-detects platform) |
brainpack push | Stage, commit, and push brain to remote |
brainpack pull | Pull latest brain state from remote |
brainpack snapshot <name> | Tag current state as a named snapshot |
brainpack snapshot --list | List all snapshots |
brainpack snapshot --restore <name> | Restore a snapshot |
brainpack export [file] | Export brain as .tar.gz |
brainpack import <file> | Import a brain archive |
brainpack diff | Show uncommitted changes and untracked files |
brainpack status | Show brain status, remote, platform, file count |
brainpack secrets | Show excluded secrets + setup guide for new machines |
brainpack secrets --check | Check which secret files exist vs missing |
brainpack auto-detects your setup:
| Platform | Detection |
|---|---|
openclaw | SOUL.md or AGENTS.md |
cursor | .cursor/ or .cursorrules |
claude-code | CLAUDE.md or .claude/ |
windsurf | .windsurf/ or .windsurfrules |
cline | .cline/ or .clinerules |
roo-code | .roo/ or .roorules |
codex | .codex/ or codex.md |
aider | .aider.conf.yml or .aiderignore |
continue | .continue/ |
goose | .goosehints |
devin | devin.md |
bolt | .bolt/ |
replit | .replit |
copilot | .github/copilot-instructions.md |
amp | .amp/ |
generic | Fallback for any setup |
brainpack init creates a brainpack.json:
{
"name": "my-agent",
"version": "0.1.0",
"platform": "openclaw",
"brainPath": ".",
"ignore": ["TOOLS.md", ".env", "*.key", ".openclaw/", ".pi/"],
"created": "2026-02-21T16:55:00.000Z"
}Files in the ignore list are excluded from exports and added to .gitignore. Keep secrets out of your brain repo.
AI agents are becoming as personal as dotfiles. The tools, APIs, and platforms will keep changing — but the core of what makes your agent yours (its personality, memory, instructions, skills) should be portable, versionable, and platform-independent.
brainpack is the git workflow for your agent's mind. Treat your brain like source code: commit it, branch it, snapshot it before big changes, share it across teams, export it for safekeeping. Platform lock-in should stop at the tool layer, not the thought layer.
PRs welcome. Keep it minimal and dependency-light.