CLI reference

fleet status

Name: Fleet
Author: Fleet

fleet status [--json] [--watch] [--chain [--stalled] [--all-projects]]

Prints an instant, color-coded health summary of your fleet: how many agents are running, stopped, or disabled; pending and dead-lettered fabric deliveries; brain and watcher daemon state; and any critical alerts or crash loops. It is the fastest way to read fleet state without opening a dashboard.

Run fleet status as your first command after starting your machine or after a deploy. Pass --json for scripts and monitoring, --watch to refresh every five seconds, or --chain to see the per-ticket reactive chain instead of agent health. status is read-only and needs no license.

Flags

--json	Emit status as a JSON object instead of the color-coded text summary
--watch, -w	Continuously refresh the display every 5 seconds until interrupted
--chain	Show the per-ticket reactive-chain view (what each ticket is waiting on) instead of agent health
--stalled	With --chain, show only stalled tickets
--all-projects	With --chain, include tickets from every project rather than just the cwd project

Examples

Print a color-coded health summary in the terminal

fleet status
# Fleet | Feral-Intelligence/forge
# Agents   3 total  2 running  1 stopped
# Fabric   0 pending
# Brain    running (PID 84312)
# Watcher  running (PID 71204)

Emit JSON for a shell script or CI step

fleet status --json
# {"agents":[...],"running":2,"stopped":1,"watcher_running":true,"watcher_pid":71204,"brain_running":true}

Watch the per-ticket reactive chain live, stalled tickets only

fleet status --chain --stalled --watch

Frequently asked questions

Does fleet status require a license?

No. status is read-only and works without an active license.

Where does fleet status get agent running state?

Agent status is determined at runtime by querying tmux for an active session. It is not persisted in the SQLite database.

What does the JSON watcher field look like?

The JSON output exposes `watcher_running` (a boolean) and `watcher_pid` (an integer), not a string status. Brain state is exposed via `brain_running` and `brain_status`.

Related commands

fleet doctor →fleet log →fleet shutdown →

Run your first agent fleet

One binary. Five minutes. See every agent, coordinate every handoff, and keep a full audit trail of what your fleet did.

See how it works Install Fleet