Downcity
AgentCLILifecycle

city agent restart

Safely restart an Agent by stopping and starting it in one operation

city agent restart

Usage

city agent restart [path]
city agent restart [path] --host 0.0.0.0

What it does

Restart is effectively:

  1. validate the target project
  2. stop the current daemon
  3. start a fresh daemon with the current options

From a user point of view, this is the "safe combined lifecycle step," not just a blind process replacement.

When restart is the right choice

Prefer restart after changing:

  • downcity.json
  • model binding
  • channel binding
  • PROFILE.md
  • SOUL.md
  • environment variables

Restart vs stop + start

The end result is similar, but restart packages the flow into one human-friendly operation.

For day-to-day project maintenance, it is usually the most convenient lifecycle command.

Continue with: