CLI reference

fleet brain

Name: Fleet
Author: Fleet

fleet brain <start|stop|status|insights|thoughts|risk|alerts|sla|audit|review|evaluate|evolve|approve|reject|approvals|auto> [flags]

Controls the brain daemon and its outputs. The daemon (fleet brain start) is an event-driven background process that evaluates agents, assesses risk, manages experiments, and polls GitHub every five minutes for PRs, reviews, CI checks, issues, and merges. It listens on ~/.fleet/brain.sock and dispatches handlers asynchronously.

Beyond start/stop/status, brain exposes a rich query surface: insights, thoughts, audit, alerts, risk, sla, plus signal commands (review, evaluate, evolve) and an approval workflow (approve, reject, approvals, auto). Starting the daemon is license-gated.

Flags

--foreground	With start, run the engine in the calling process instead of daemonizing
--agent <name>	With insights / risk, filter to a specific agent; with evaluate, the agent to score
--project <repo>	With insights, scope to a specific project
--all-projects	With insights, show agents across every project
--json	Emit insights, thoughts, risk, alerts, sla, audit, or approvals as JSON

Examples

Start the brain daemon (forks and returns)

fleet brain start
# brain daemon started (PID 84312)
# logs: ~/.fleet/logs/brain.log

Check daemon status

fleet brain status
# {"daemon":"running","pending_approvals":0,"approval_required":true,...}

Surface actionable agent insights as a table

fleet brain insights
# BRAIN INSIGHTS
# AGENT          PROJECT       SCORE GRADE RISK     EVOLVE
# frontend-dev   forge          76.0 C     medium   OFF

Frequently asked questions

Does fleet brain require a license?

Yes. `fleet brain start` is license-gated. Query subcommands read local data.

How do I run the brain in the foreground?

Use `fleet brain start --foreground`. Bare `fleet brain start` forks a detached daemon and returns immediately. There is no --org flag on brain start.

Related commands

fleet eval →fleet log →fleet watcher →

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