CLI Reference

Complete reference for all fleet subcommands. Run fleet --help or fleet <command> --help for inline usage.

Subcommand overview

fleet                           # Show fleet status (default)
fleet status                   # Fleet health summary
fleet doctor                   # System prerequisite check
fleet init                     # Initialize .fleet/config.yaml
fleet shutdown                 # Stop everything
fleet agent                    # Agent lifecycle management
fleet task                     # Task dispatch
fleet team                     # Team management
fleet template                 # Agent template catalog
fleet event                    # Event queries
fleet config                   # Configuration management
fleet workflow                 # Workflow definitions
fleet brain                    # Brain daemon
fleet eval                     # Agent evaluation
fleet fabric                   # Fabric event bus
fleet pipeline                 # Pipeline orchestration
fleet mcp                      # MCP server
fleet log                      # Unified fleet log
fleet watcher                  # Watcher daemon

General

fleet

fleet

Show fleet status. The default command when no subcommand is provided.

Example

fleet

fleet status

fleet status [--json]

Show instant fleet health summary with color-coded agent statuses.

Flags

Flag	Description
--json	Output as JSON for programmatic use

Example

fleet status --json

fleet doctor

fleet doctor

Check system prerequisites: tmux, SQLite, unix sockets, gh CLI, and Go version.

Example

fleet doctor

fleet init

fleet init

Initialize a new .fleet/config.yaml in the current repository.

Example

fleet init

fleet shutdown

fleet shutdown

Stop the watcher, org watcher, and all running agents. Clean shutdown of the entire fleet.

Example

fleet shutdown

Agent Management

fleet agent start

fleet agent start <name> [--all] [--enabled] [--team <name>]

Start one or more agents in tmux sessions.

Flags

Flag	Description
<name>	Start a specific agent by name
--all	Start all configured agents
--enabled	Only start agents marked as enabled (with --all)
--team <name>	Start all agents in a specific team

Example

fleet agent start frontend-dev
fleet agent start --all --enabled
fleet agent start --team engineering

fleet agent stop

fleet agent stop <name> [--all]

Stop a running agent or all agents.

Flags

Flag	Description
<name>	Stop a specific agent
--all	Stop all running agents

Example

fleet agent stop --all

fleet agent budget

fleet agent budget

Show per-agent budget utilization including cumulative run duration and limits.

Example

fleet agent budget

fleet agent rollback

fleet agent rollback <name>

Roll back an agent's configuration to a previous revision.

Example

fleet agent rollback frontend-dev

Task Dispatch

fleet task assign

fleet task assign <agent> <task>

Dispatch a specific task to a specific agent. Sets FLEET_TASK_TITLE on the agent session.

Example

fleet task assign frontend-dev "Implement dark mode toggle"

Watcher Daemon

fleet watcher start

fleet watcher start [--supervised] [--org]

Start the watcher daemon. Runs three loops: label watcher (2 min), subscription processor (10s), and agent scheduler.

Flags

Flag	Description
--supervised	Run in foreground with log output
--org	Start the org-level watcher instead of repo-level

Example

fleet watcher start --supervised

fleet watcher stop

fleet watcher stop [--org]

Stop the watcher daemon.

Flags

Flag	Description
--org	Stop the org-level watcher

Example

fleet watcher stop

fleet watcher status

fleet watcher status [--org]

Check whether the watcher daemon is running.

Flags

Flag	Description
--org	Check org-level watcher status

Example

fleet watcher status

Pipeline Management

fleet pipeline run

fleet pipeline run <name> --title <text>

Start a new pipeline run. Creates tasks for the first stage and begins orchestration.

Flags

Flag	Description
<name>	Pipeline name as defined in config
--title <text>	Title describing this run

Example

fleet pipeline run deploy --title "Release v1.13"

fleet pipeline signal

fleet pipeline signal --run <id> --agent <name>

Signal that an agent has completed its pipeline stage. Advances the run to the next stage.

Flags

Flag	Description
--run <id>	Pipeline run ID
--agent <name>	Agent that completed the stage

Example

fleet pipeline signal --run 42 --agent qa-lead

fleet pipeline watch

fleet pipeline watch <id>

Watch a pipeline run in real-time, showing stage progression and agent status.

Example

fleet pipeline watch 42

Observability

fleet log

fleet log [--agent <name>] [--type <type>] [--since <duration>] [--json]

Unified decision/conversation history. Merges fabric events and activity events into a chronological timeline.

Flags

Flag	Description
--agent <name>	Filter logs by agent name
--type <type>	Filter by event type
--since <duration>	Show logs since duration (e.g., 1h, 30m)
--json	Output as JSON

Example

fleet log --agent frontend-dev --since 2h

fleet eval

fleet eval <agent>

Run a 6-dimension evaluation on an agent: task output, reliability, quality, efficiency, collaboration, and cost.

Example

fleet eval frontend-dev

Fabric & Events

fleet fabric

fleet fabric <subcommand>

Interact with the Fabric event bus. Manage events, claims, inbox, and subscriptions.

Example

fleet fabric events --since 1h

fleet event

fleet event <subcommand>

Manage and query agent events.

Example

fleet event list

Configuration & Templates

fleet config

fleet config <subcommand>

View and manage fleet configuration.

Example

fleet config show

fleet template

fleet template <subcommand>

Manage agent templates from the 136-template catalog.

Example

fleet template list

fleet team

fleet team <subcommand>

Manage teams of agents.

Example

fleet team list

Brain & MCP

fleet brain start

fleet brain start

Start the Brain daemon. Event-driven handler for eval, risk, alerts, quarantine, and evolve. Listens on ~/.team-dashboard/brain.sock.

Example

fleet brain start

fleet mcp serve

fleet mcp serve

Start the MCP server. Exposes 26 tools over JSON-RPC 2.0 via stdio for Claude Code integration.

Example

fleet mcp serve

Workflow

fleet workflow

fleet workflow <subcommand>

Manage workflow definitions and execution.

Example

fleet workflow list