fleet

fleet

A terminal dashboard for managing multiple AI agent sessions in tmux.

Fleet watches your Claude Code sessions, shows which agents need attention, and lets you send prompts — all from a single pane. It replaces a sprawl of bash scripts with a compiled Bun binary and a Claude Code plugin that hooks into the event system automatically.

Install

Homebrew

brew install nicknisi/formulae/fleet

From source

git clone https://github.com/nicknisi/fleet.git
cd fleet
bun install
bun run build
# Binary is at dist/fleet — add to your PATH

Claude Code plugin

Fleet hooks into Claude Code's event system to track agent state in real time. Install the plugin after building:

fleet install

This does three things:

1. Registers Fleet as a Claude Code plugin (hooks fire automatically in all new sessions)
2. Adds a second tmux status row showing all active agents
3. Adds a run-shell line to your tmux.conf (marked # fleet-managed)

No settings.json editing required.

To remove everything cleanly:

fleet uninstall

Usage

TUI Dashboard

fleet                   # Launch dashboard (preview auto-opens on wide terminals)
fleet --preview         # Force preview pane on
fleet --no-preview      # Force preview pane off

The dashboard shows every Claude Code pane grouped by urgency. Agents that need you sort to the top. Plain shell panes are hidden — you're here for the agents.

Each row leads with the tmux session name. When Claude Code has auto-named a session (the descriptive title it generates per task), Fleet shows that name in the detail column so you can tell sessions apart at a glance. Filtering with / matches on session name, Claude name, and project path.

Keybindings

Key	Action
j / k or Up / Down	Navigate sessions
Enter	Switch to selected session
n	Jump to next waiting agent (cycles)
p	Toggle preview pane
s	Send prompt to selected session
i	Enter passthrough (preview mode)
y	Approve permission prompt (preview)
/	Filter sessions by name or project
x	Kill selected session (confirms first)
?	Help overlay
q or Esc	Quit (or clear filter)

You can also click a session row to select it; clicking a ready agent acknowledges it in place (see Acknowledge).

Agent States

Fleet tracks seven states, sorted by urgency. The icon and color tell you what's happening at a glance:

Icon	State	Meaning
⚠	waiting	Tool approval needed ([y/n] prompt)
?	asking	Agent asked you a question (AskUserQuestion)
◉	working	Thinking or running tools
●	ready	Turn ended — your move (finished, or asked in prose); green dot
●	idle	Up but no recent activity (blue dot)
■	shell	No agent running (hidden by default)
○	down	No live process (hidden by default)

asking vs. ready: A turn that ends — whether the agent finished the task or asked you something in prose — looks identical at the hook layer (both are a plain Stop). Fleet can't tell them apart, so both land in ready ("your move"). The dedicated asking state is only reachable through structured signals the agent emits: the AskUserQuestion tool and MCP elicitation dialogs. Either way both sort into the attention tier, so nothing that needs you gets buried.

Send Mode

Press s to send a prompt to the selected agent. Fleet auto-selects the first sendable session if the current one is busy or waiting for approval.

State gating: Fleet refuses to send to sessions with permission prompts (won't accidentally approve), sessions asking questions (won't answer for you), or dead sessions. Use --force in the CLI to override the busy check.

Kill Session

Press x to kill the selected session's pane. Fleet asks you to confirm (y) before closing it — any other key cancels.