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. Beyond hooked agents (Claude Code, Codex, pi), it also surfaces ones it has no integration for — aider, opencode, and the like — by spotting them in the process table.

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. Install also offers two optional tmux keybindings — a sidebar split and a popup (see Sidebar & popup).

To remove everything cleanly:

fleet uninstall

Codex

Fleet also tracks Codex sessions. Codex has no plugin marketplace, so fleet install codex wires fleet into Codex's own config instead:

fleet install codex

This:

1. Creates the Codex status dir (~/.cache/codex-status)
2. Adds fleet PreToolUse + Stop hooks to ~/.codex/hooks.json (your own Codex hooks are preserved)
3. Ensures [features] hooks = true in ~/.codex/config.toml
4. Registers codex in ~/.config/fleet/agents.json

Re-run it after a brew upgrade to re-point fleet's hook path. Codex panes then appear on the dashboard labeled codex, alongside claude. To reverse it (leaving your own Codex hooks intact):

fleet uninstall codex

pi

Fleet also tracks pi sessions. pi has no shell hooks — it loads TypeScript extensions auto-discovered from ~/.pi/agent/extensions/ — so fleet install pi drops fleet's extension there:

fleet install pi

This:

1. Creates the pi status dir (~/.cache/pi-status)
2. Symlinks the fleet-pi extension into ~/.pi/agent/extensions/ (your own pi extensions are untouched)
3. Registers pi in ~/.config/fleet/agents.json

The extension publishes fleet status from pi's agent_start / tool_execution_start / agent_end lifecycle events, so pi panes appear on the dashboard labeled pi (working / idle / done). pi auto-runs its tools, so there is no permission-prompt (PERMIT/QUESTION) state to surface — working/done is the full picture. Re-run after a brew upgrade to re-point the extension; in an already-running pi session, /reload picks it up. To reverse it (leaving your own pi extensions intact):

fleet uninstall pi

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.

The header carries a live summary strip — N need you · N working · N ready · N idle — so you can read the fleet's overall state without scanning rows. When there's nothing to list, Fleet tells you why with a distinct empty state: tmux isn't running, the hooks aren't installed yet, your filter matched nothing, or everything's genuinely quiet.

A few more cues while you work:

• Hover — the row under your mouse underlines, so you can see what a click will select.
• Scroll indicators — ↑ N more / ↓ N more appear when the list outruns the viewport.
• Busy pulse — a working agent's ◉ icon pulses on each tick, so active turns read as alive at a glance.

Sidebar & popup

fleet install offers two optional tmux keybindings (each confirm-gated, marked # fleet-managed so fleet uninstall strips them again):