Skip to main content

​
Troubleshooting

​
Audience

This page is for developers and operators troubleshooting install, deployment, agent execution, and runtime issues.

​
Goal and Scope

This page organizes high-frequency troubleshooting flows across CLI, task state, logs, and UI.

​
Common Troubleshooting Paths

​
Cluster or platform startup fails

aios doctor
aios infra cluster status

​
Agent task stalls or produces no output

aios agent run list --limit 20
aios agent run get <run-id>
aios agent run logs <run-id>

​
CLI and UI correlation

aios infra app logs <app-name> --since 30m > app.log

​
Pitfalls / Risk Notes

  • do not treat audit as just another log stream
  • single-instance in-memory state makes troubleshooting far harder