> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiml-code-it.automat-it.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ and troubleshooting

> Short answers to common problems.

> [accordion] My laptop shows offline
>
> Run `code-it-runner doctor`. If it reports a problem, run `code-it-runner repair`. If it says the token is rejected, run `code-it-runner login --api https://api.aiml-code-it.automat-it.io`. See [runner troubleshooting](https://docs.aiml-code-it.automat-it.io/guides/runner.md).

> [accordion] My agent is stuck at waiting\_for\_runner
>
> The owner's runner is not connected. Start or repair it on the owner's laptop. The agent launches when the runner connects.

> [accordion] The agent cannot clone the repository
>
> The runner clones with your `gh` login. Run `gh auth status`, then `gh auth login` for the right org, and retry.

> [accordion] The grid shows aws\_session\_expired
>
> Run `aws sso login --profile <aws-profile>`. The next turn picks it up.

> [accordion] The agent cannot deploy to AWS
>
> Set a profile for the project: `code-it-runner aws-profile <project-slug> <profile>`.

> [accordion] The installer says it supports macOS only
>
> That is current behaviour. The LaunchAgent install is macOS only.

> [accordion] Do my AWS credentials leave my laptop?
>
> No. The runner uses your named profile through the `aws` CLI and never reads credentials in-process. The platform does not receive them.

> [accordion] Who pays for Kiro credits?
>
> Your own Kiro plan, since the agent runs on your Kiro login.

> [accordion] A page shows zeros
>
> Metrics pages read live platform data and some depend on repositories and Asana boards being configured on the project. Check the project's Tickets and Repositories settings first, then tell the platform admin.

> [accordion] Agent chat is empty or does not stream
>
> Check the runner is connected and that the agent is running. Run `code-it-runner logs --follow` while sending a prompt.

> [accordion] Can the agent apply Terraform without asking?
>
> No. `terraform apply`, `cdk deploy`, `cloudformation deploy` and `sam deploy` go through the `code-it-apply` gate and wait for your approval.

## Still stuck

Open an issue in the [repository](https://github.com/automat-it/ait-ai-delivery-code-it) or ask the platform admin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.