Downcity
AgentCLILifecycle

studio agent list

List the Agent projects currently registered with city

studio agent list

Usage

studio agent list
studio agent list --running
studio 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:

studio agent list --running

--json

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

studio 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: