One small binary to connect, observe, coordinate, and supervise long-running CLI agents across a server.
curl -fsSL https://github.com/tunapro1234/blueprint/releases/latest/download/install.sh | sh -s -- --local
$ bp tree
main [idle/open]
├── main-docs [idle/open]
├── main-tests [working/open]
└── app [idle/open]
├── app-web [working/open]
│ └── app-build blueprint@builder/dev
└── app-api [idle/open]
$ bp msg app-web "ship the pricing page when tests pass"
BUSY: queued (channel: q4829) — check: bp qstat q4829
$ bp qstat q4829
DELIVERED: app-web (at 14:32)
$ bp open app-pricing ~/projects/app --worktree pricing
.worktrees/pricing · branch pricing/dev · agent ready
$ bp usage
Claude 5h 12% · 7d 27% Codex 5h 4% · 7d 14%A fleet of agents in tmux — opened, messaged, queued, branched into worktrees, usage-governed. Ordinary messages wait while an agent is busy or its composer contains user input.
A CLI such as Claude or Codex living in its own named tmux session.
An agent spawned inside a CLI through Task, a workflow, or codex exec.
Sessions keep agents alive, addressable, observable, and easy to reconnect to.
For explicitly configured remote sessions, bp uses mosh when installed and SSH otherwise. A failed mosh connection is reported.
Install and sign in to your preferred agent CLI first. Use the signed installer above, then open a new terminal.
bp doctorChoose a CLI. A main agent receives portable guidance to help configure this machine.
bp onboardExisting aliases are preserved. Continue a Claude conversation without creating another bp owner.
claude -c| bp onboard · bp book --json | Set up the coordinator and inspect agent records. |
| bp doctor · bp update --check | Diagnose installation and check signed releases. |
| bp tree | Show the agent hierarchy with live state. |
| bp status | Compare live tmux sessions with the agentbook. |
| bp open <name> <dir> [--worktree t] | Start an agent, optionally inside a fresh git worktree. |
| bp close <name> | Close an agent session; its history is kept. |
| bp msg <name> <message> | Send now, or queue safely when the agent is busy. |
| bp q · bp qstat <id> · bp qcancel <id> | List, inspect, or cancel queued messages. |
| bp announce <message> | Broadcast down the sender's agent hierarchy. |
| bp peek <name> [n] | Read the latest lines from a session. |
| bp usage · bp monitor | Model-usage snapshot; full dashboard in the terminal. |
| bp policy status|override | Inspect or pause the usage policy engine. |
| bp service | Health of every supervised job. |
| bp con [name] | List sessions or attach locally / over mosh. |
| bp dash | Serve the monitoring dashboard locally. |
| bp img | Ship a clipboard image to the server; path comes back on your clipboard. |
Copy an image on your laptop and run bp img. It uploads to the server, prints the saved path, and puts that path back on your clipboard. One-key kitty launcher:
map ctrl+shift+i launch --type=background bp img
Local bp sessions enable mouse scrolling and apply their own status bar. Existing tmux prefix settings are preserved; clipboard support depends on your terminal.
Local installations run with tmux and per-session queue workers; systemd is not required. Configured servers can run bp daemon for shared queues and scheduled jobs.