blueprint · agent infrastructure CLI

Orchestrate a fleet of AI agents in tmux.

One small binary to connect, observe, coordinate, and supervise long-running CLI agents across a server.

curl -fsSL https://bp.tunapro.xyz/install.sh | bash

Linux & macOS · single static binary · or npm i -g @tunapro/blueprint

you@laptop — bp

$ 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: q4829) — check: bp qstat q4829

$ bp qstat q4829
DELIVERED: probot-studio (at 14:32)

$ bp open probot-pricing /srv/probot/studio --worktree pricing
.worktrees/pricing · branch pricing/dev · agent ready

$ bp usage
Claude  5h 12% · 7d 27% · Fable 43%      Codex  5h 4% · 7d 14%

A fleet of agents in tmux — opened, messaged, queued, branched into worktrees, usage-governed. Nothing ever talks over a busy agent.

Concepts

Agent

A CLI such as Claude or Codex living in its own named tmux session.

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 stay comfortable; SSH remains the automatic fallback.

Quickstart

01 · SERVER

Install on the server

From the blueprint checkout, build and link the server binary.

cd /srv/blueprint && ./install.sh

02 · LAPTOP

Install on your laptop

The installer downloads the native binary and asks for your user@host.

curl -fsSL bp.tunapro.xyz/install.sh | bash

03 · CONNECT

Attach to any agent

Local sessions attach directly; remote sessions go over mosh or SSH.

bp con server-main

Command reference

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.

Desktop integration

Image paste over SSH

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

Clipboard & scroll

The installer can add mouse scrolling, deep history, vi copy-mode, and OSC52 clipboard forwarding, so copying works through tmux and mosh. It asks first and never touches your prefix key.

Architecture

One daemon.
Long-lived work.

A single systemd unit, blueprint.service, runs the blueprint daemon. It supervises the scheduled jobs — usage tracking, policy, the message queue, keepalive — while tmux remains the durable session layer for the fleet.

blueprint.service→bp daemon→scheduled jobs