AgentCLIMaintenance
Agent Registry
Understand what the city registry stores and how it relates to actual runtime state
Agent Registry
city agent list shows the set of agents known to the city registry.
What the registry represents
From a user perspective, it tells you:
- which project agents city knows about
- which project root belongs to each one
- whether they currently appear as running or stopped
Its biggest value is discoverability and target selection.
Why it matters
Several CLI experiences depend on it:
city agent list- interactive target selection in
city agent start city agent chat --to <name>
Without the registry, many workflows would degrade into "you must remember absolute paths."
Registry vs actual daemon state
The registry is registration and discovery state.
The real process state still depends on daemon inspection.
That is why list and status are related, but not the same kind of command.
Continue with: