Agent
A CLI such as Claude or Codex living in its own named tmux session.
Concepts
Subagent
An agent spawned inside a CLI through Task, a workflow, or codex exec.
tmux is the fabric
Sessions keep agents alive, addressable, observable, and easy to reconnect to.
mosh makes remote sweet
Roaming and intermittent connections are comfortable; SSH remains the automatic fallback.
Quickstart
Install on the server
From the blueprint checkout, build and link the server binary.
cd /srv/blueprint
./install.shInstall on your laptop
The installer downloads the native binary and asks for your user@host.
curl -fsSL https://bp.trasumanar.ai/install.sh | bashConnect to an agent
Local sessions attach directly; remote sessions use mosh or SSH.
bp con server-mainWhat a day with bp looks like
$ bp tree
server-main [idle/open]
├── server-mail [idle/open]
├── server-monitor-dash [working/open]
└── probot-main [idle/open]
├── probot-studio [working/open]
│ └── probot-builder blueprint@builder/dev
└── probot-business [idle/open]
$ bp msg probot-studio "ship the pricing page when tests pass"
BUSY: queued (channel: q482910337). Check: bp qstat q482910337
$ bp qstat q482910337
DELIVERED: probot-studio (at 14:32)
$ bp open probot-pricing /srv/probot/studio --worktree pricing
/srv/probot/studio/.worktrees/pricing · branch pricing/dev · agent ready
$ bp usage
Claude: 5h %12 · 7d %27 · Fable 7d %43 Codex: 5h %4 · 7d %14
$ bp announce "deploy frozen for 1h, finish open work"
sent: 6, queued: 2 (q519, q533)One binary. A fleet of agents in tmux — opened, messaged, queued, branched into worktrees, usage-governed. Nothing talks over a busy agent, ever.
Command reference
| Command | Purpose |
|---|---|
| bp status | Compare live tmux sessions with the agentbook. |
| bp tree | Show the agent hierarchy and live state. |
| bp open <name> <dir> | Start an agent in a new tmux session. |
| bp close <name> | Close an agent session while retaining its history. |
| bp msg <name> <message> | Send now or queue safely when the agent is busy. |
| bp q | List queued agent messages. |
| bp qstat <channel-id> | Inspect delivery status for a queued message. |
| bp peek <name> [n] | Read the latest non-empty lines from a session. |
| bp announce <message> | Broadcast down the sender's agent hierarchy. |
| bp usage | Show the latest model-usage snapshot. |
| bp policy status|override | Inspect or temporarily override usage policy. |
| bp service | Show supervised job state. |
| bp con [agent-name] | List sessions or attach locally/remotely to an agent. |
| bp img | Upload a local clipboard image over SSH and copy its server path back. |
Desktop integration
Image paste over SSH (bp img)
Copy an image on your laptop and run bp img. It uploads the image to the server, prints the saved path, and puts that path back on your local clipboard.
Add a one-key launcher to ~/.config/kitty/kitty.conf:
map ctrl+shift+i launch --type=background bp imgClipboard & scroll (tmux + OSC52 + mosh)
The installer can add mouse scrolling, deep history, vi copy mode, and tmux clipboard integration after asking for permission.
OSC52 clipboard forwarding and tmux passthrough keep text copy working through mosh; no prefix-key changes are made.
Architecture
One daemon.
Long-lived work.
A single systemd unit, blueprint.service, runs the blueprint daemon. It supervises the scheduled jobs — usage tracking, policy, message queue, keepalive — while tmux remains the durable session layer for the agent fleet.
blueprint.service→bp daemon→scheduled jobs