aasm status
Show fleet health, agents, approvals, and budget at a glance. aasm status
fetches the deployment overview, runtime health, agent list, pending
approvals, cost rollup, and storage health from the gateway in one shot and
renders a dashboard-style summary.
Synopsis
aasm status [OPTIONS]
This command has no subcommands.
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--watch | flag | off | Auto-refresh the status display every 5 seconds. Runs until interrupted (Ctrl-C). |
--json | flag | off | Print only the deployment-overview header as machine-readable JSON (the AAASM-1579 contract). Distinct from --output json, which serializes the full snapshot. |
Plus the global options.
Exit code
0— all healthy.- non-zero — the gateway is unreachable, at least one agent has violations, or
the storage health probe reports
unavailable. All failure modes collapse to a single non-zero code so shell scripts can gate on it.
Examples
Show the full status summary:
aasm status
Agent Assembly Status
─────────────────────────────────────
Mode: local
Gateway: http://localhost:7391
Storage: sqlite (~/.aasm/local.db)
Version: 0.0.1
Uptime: 2h 15m 33s
Health: ✓ ok
─────────────────────────────────────
Active Agents
ID NAME FRAMEWORK STATUS SESSIONS VIOLATIONS LAST EVENT
a1b2… research-bot langgraph active 3 0 2m ago tool_call
Pending Approvals: 1 (oldest 2m 15s)
Budget: $12.50 / $50.00 daily ███████░░░░░░░░░░░░░ 25%
Continuously refresh:
aasm status --watch
Machine-readable deployment header for CI:
aasm status --json
{
"mode": "local",
"gateway_url": "http://localhost:7391",
"storage_backend": "sqlite",
"storage_path": "~/.aasm/local.db",
"version": "0.0.1",
"uptime_secs": 8133,
"health": "ok"
}
Full snapshot as JSON (every section):
aasm status --output json
Last updated: 2026-06-11 by Chisanan232