Troubleshooting

The repository does not currently ship the aios ... troubleshooting commands shown below. They are retained only as direction for a future CLI troubleshooting flow.

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

Operations Overview
Logging Architecture
Web UI Guide

​Troubleshooting

​Audience

​Goal and Scope

​Common Troubleshooting Paths

​Cluster or platform startup fails

​Agent task stalls or produces no output

​CLI and UI correlation

​Pitfalls / Risk Notes

​Related Pages