Agent CLI Overview

city agent is the command surface for the single-project Agent runtime.

If you think of the Agent as "the execution unit for one project," the city agent command group is its operator console.

What you can do with it

• initialize an Agent project
• start or stop background agent daemons
• inspect registered agents
• chat with agents from the terminal
• clean broken session history
• diagnose and repair stale daemon state

The easiest way to understand the commands

Lifecycle

• create
• start
• stop
• restart
• status
• list

These answer:

• is the project initialized?
• is it running?
• how do I start, stop, or restart it safely?

Interaction

• chat
• history clean
• interactive city agent manager

These answer:

• how do I talk to the agent?
• how do I reset a bad session?
• how do I manage agents interactively without memorizing every flag?

Maintenance

• doctor
• daemon state inspection
• registry inspection

These answer:

• why does the runtime state look wrong?
• why does it say it ran before but now it is unreachable?
• why do list and status appear to disagree?

Recommended first reading order

1. create
2. start
3. chat
4. status
5. stop / restart
6. doctor

Continue with:

• Lifecycle commands
• Interaction commands
• Maintenance commands