Downcity
AgentCLILifecycle

city agent list

List the Agent projects currently registered with city

city agent list

Usage

city agent list
city agent list --running
city agent list --json

What it lists

This command shows agent projects registered in the city registry.

It does not mean "scan the current directory tree for repos."

That is why you may see:

  • an agent listed in list
  • but not currently in a running state

--running

Only show currently running agents:

city agent list --running

--json

Use structured output when a script or toolchain will consume the result:

city agent list --json

When to use it

  • when you are not sure which projects are already registered
  • when you want to pick a target before chat
  • when you want to inspect which agents are currently running

If you are unsure which agent to talk to, list followed by chat --to ... is usually the safest path.

Continue with: