Downcity
AgentOperationsTroubleshooting

Agent Shows stale

What to do when status returns stale

Agent Shows stale

stale means:

  • the state file still exists
  • but the daemon process behind it is missing or inconsistent

Standard recovery

city agent doctor --fix
city agent start

Common causes

  • abnormal exit
  • machine restart
  • previous startup that did not clean up completely

This is usually a state-consistency problem, not a sign that the project configuration itself is broken.