> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Common Agent, CLI, and automation troubleshooting guidance in AiOS.

# FAQ

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

## Q1: Why does cluster startup fail?

Run environment diagnostics first and verify runtime prerequisites.

```bash theme={null}
aios doctor
aios infra cluster status
```

## Q2: Why is an agent run stuck?

Check run status and logs before retrying.

```bash theme={null}
aios agent run list --limit 20
aios agent run get <run-id>
aios agent run logs <run-id>
```

## Q3: How to troubleshoot across CLI and UI?

Export logs from CLI and correlate timelines in UI.

```bash theme={null}
aios infra app logs <app-name> --since 30m > app.log
```

## Q4: How to add a new AI tool?

Register credentials and verify connectivity.

```bash theme={null}
aios agent tool add <tool-name> --token <token>
aios agent tool test <tool-name>
```

## Q5: How to manage credentials securely?

* inject credentials through environment variables or a secrets manager
* never commit tokens into source control
* rotate privileged credentials regularly

## Related Pages

* [Agent Overview](/en/agent/index)
* [Production Step-Up and Approval](/en/agent/production-approval)
* [Operations Overview](/en/operations/index)