AgentOperationsTroubleshooting
Agent Will Not Start
A practical troubleshooting order when city agent start fails
Agent Will Not Start
Check these four things first:
- whether the project has been initialized
- whether
execution.modelIdexists - whether the target model can be resolved in the global model pool
- whether environment variables and project configuration are actually ready
Recommended troubleshooting order
city agent status
city agent start --foregroundForeground startup usually makes startup-stage errors much easier to see.
If foreground mode already shows a clear configuration error, do not keep bouncing back to background mode and retrying blindly.