CommandsAgent
city agent status
Show target agent runtime status
city agent status
Show runtime status for a target agent.
Usage
city agent status [path]Behavior
pathdefaults to current directory.- Target agent must be registered in console registry
- Output includes runtime state, process info, and key paths
- When state is
stale, output includesstale_reasonfor direct diagnosis
Related commands
Example Output (Based on Current Implementation)
The examples below are aligned with current command implementations in package/src (including default output mode and field structure). Placeholder values are used for environment-specific fields.
$ city agent status .
city version: 1.0.0
┌─────────────────────────────────────────────────────────┐
│ OK city agent status │
│ project : <projectRoot> │
│ log : <daemonLogPath> │
│ state : running │
│ pid : <pid> │
│ started_at : <isoTimestamp> │
└─────────────────────────────────────────────────────────┘$ city agent status .
city version: 1.0.0
┌─────────────────────────────────────────────────────────┐
│ WARN city agent status │
│ project : <projectRoot> │
│ log : <daemonLogPath> │
│ state : stale │
│ stale_pid : <pid> │
│ stale_reason : <reason> │
│ fix : city agent doctor <projectRoot> --fix │
└─────────────────────────────────────────────────────────┘