Downcity
CommandsConsole

city console agents

List managed agents (running + historical)

city console agents

List managed agents including running and historical entries.

Usage

city console agents [--json]

Behavior

  • Lists currently running managed agent runtimes.
  • Historical entries are preserved in registry (status=stopped).
  • --json outputs machine-readable result.

In Console UI, Global Agents can start an agent directly from history.

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 console agents --json
{
  "success": true,
  "count": 2,
  "agents": [
    {
      "projectRoot": "<projectRootA>",
      "daemonPid": 12345,
      "running": true,
      "startedAt": "<iso>",
      "updatedAt": "<iso>",
      "logPath": "<logPathA>"
    }
  ]
}
$ city console agents
city version: 1.0.0
┌──────────────────────────────────────┐
│ INFO managed agents                  │
│   agents   : 0                       │
│   detail   : no running agent daemon │
└──────────────────────────────────────┘

Table of Contents