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:
- Registers Fleet as a Claude Code plugin (hooks fire automatically in all new sessions)
- Adds a second tmux status row showing all active agents
- 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.
