Once you start dispatching work from the dashboard, agents work becomes the long-lived process that matters most.
The agents CLI is the local execution surface for the product. The dashboard can queue work, but the CLI is what actually runs sessions, syncs state, and manages previews.
Top-level help
agents --helpCurrent top-level commands include:
-
digest -
find -
init -
preview -
work
Current command groups include:
-
backlog -
log -
preview -
reference -
resource -
session -
state -
trace -
triage
Source: packages/cli/package.json and packages/cli smoke
High-signal commands
agents work, agents work --once, and agents work --install bridge queued web work to local machine execution.
packages/cli/src/cli/commands/work.ts
agents session start, list, show, replay, and await cover spawning, inspection, replay, heartbeat, and cleanup.
agents preview, status, and stop orchestrate sprite VMs for live review.
agents trace start, agents trace progress, agents report start, and agents report complete expose the lifecycle surfaces used by tools and compatibility shims.
TUI
The CLI also exposes a terminal dashboard launcher:
agents tuiSource: packages/cli/src/cli/commands/tui.ts
Operator guidance
Keep the web UI open for visibility, but keep the CLI running for execution. agents work is the most important long-lived process in the system once dashboard dispatch is in use.
Source of truth
- Package metadata
- packages/cli/package.json
- Commands
- packages/cli/src/cli/commands/…
- Session manager and sync helpers
- packages/cli/src/lib/…