Your Pi setup, on every machine.
One binary syncs them over git. No server, no secret leaks, plain SSH.
$ git clone https://github.com/zhugez/pi-capsule && cd pi-capsule && ./scripts/restore.sh
dev@machine: ~/pi-capsule — bash — 82x24
# machines
any
# leaked secrets
0
# companion tools
8
# licence
GPL
01 // TOPOLOGY
One sync, every host.
Each host is reached directly over git or SSH. Nothing sits in the middle.
~/.pi/agent ──────export.sh─────▶ agent/ ──────git push─────▶ GitHub
│
new machine ◀─────restore.sh──── agent/ ◀─────git clone────────┘
02 // AIR GAP GUARANTEE
Secrets stay home.
Literal API keys are swapped for $ENV_VAR references before committing. Never leaked to git.
models.json (sanitized on export)
git diff
- -"apiKey": "sk-ant-api03-92f8a...real_secret_token...a01"
- +"apiKey": "$MACMINI_CODEX_API_KEY"
- "defaultModel": "anthropic/claude-3-7-sonnet"
- "thinkingLevel": "high"
03 // ROSTER
8 Companion CLIs.
Auto-bootstrapped and mounted during restore if not already present on $PATH.
| Module | Designation | Config Mount |
|---|---|---|
| no-mistakes | Pre-push automated verification gate (git gate) | ~/.no-mistakes/config.yaml |
| rtk | Token-saving compression and caching CLI proxy | ~/.config/rtk/*.toml |
| agent-browser | Native Chrome CDP browser automation CLI | ~/.agent-browser/config.json |
| treehouse | Reusable git worktree pool manager for agent branches | ~/.config/treehouse/config.toml |
| gitleaks | Secret scanner CLI in global pre-commit hooks | ~/.config/git/hooks/pre-commit |
| ExoMind | Persistent memory runtime and knowledge graph (exom) | ~/.exomind/ |
| crapper | Uncle Bob mode CRAP metric complexity analyzer | ~/.local/share/ub-tools/crapper |
| mutator | Mutation testing engine for unit test validation | ~/.local/share/ub-tools/mutator |
04 // EXTENSIONS
pi-pulse Extension Suite.
Bundled and reconciled automatically via git:github.com/zhugez/pi-pulse on every sync.
| Extension | Type / Tool | Capability |
|---|---|---|
| goal | /goal command | Conversational multi-step goal planning, task hierarchy, and independent completion auditor |
| todo | todo tool, /todos | Persistent 4-state task state machine (pending → in_progress → completed), blockedBy dependencies, live UI board |
| advisor | ask_advisor tool | On-demand strategic second opinion, gated completion reviews, and multi-turn consultation chains |
| model pools | codex / workbuddy | Native multi-account pooling with account labels, per-model rate limits, realm-aware effort, and automated failover |
| code-mode | code_exec tool | Async in-sandbox JavaScript orchestration for multi-file checks and bulk ops without context bloat |
| lens | code_inspect tool | Real-time syntax diagnostics, unread file edit guards, and instant symbol outlines |
| loop-guard | runtime guard | Deadlock-free detection blocking repeating identical tool calls with actionable escalation guidance |
| gates | /crap, /mutator | Uncle Bob complexity metrics (CRAP ≤ 10) and mutation testing gates verifying test robustness |
05 // DISPATCH
Install on fresh host.
Pick your environment. One command restores the entire agent workstation.
# Linux or macOS:
git clone https://github.com/zhugez/pi-capsule && cd pi-capsule && ./scripts/restore.sh
# Windows (PowerShell 7+):
git clone https://github.com/zhugez/pi-capsule ; cd pi-capsule ; powershell -ExecutionPolicy Bypass -File .\scripts\restore.ps1
# Native Pi package registration:
pi install git:github.com/zhugez/pi-capsule