From 4e71bde7d2cbb19813dd13b4b17ce6eea5ee232d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 16 Oct 2026 07:19:45 +0000 Subject: [PATCH] docs: sync gateway with merged PRs (2026-10-16) --- packages/kilo-docs/pages/ai-providers/index.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/packages/kilo-docs/pages/ai-providers/index.md b/packages/kilo-docs/pages/ai-providers/index.md index f757db8b9869..8949ff6f6861 100644 --- a/packages/kilo-docs/pages/ai-providers/index.md +++ b/packages/kilo-docs/pages/ai-providers/index.md @@ -90,6 +90,20 @@ To allow only specific providers and disable everything else, use `enabled_provi Both fields accept provider IDs — the lowercase identifier used in the `provider/model` format (e.g. `kilo`, `anthropic`, `openai`, `google`, `groq`). +## When a provider fails to load + +If Kilo Code cannot fetch a provider's models — for example, because the provider rejected your credentials or its API is unreachable — it keeps the provider visible and shows the reason instead of hiding it. The reason appears wherever you pick a provider: the VS Code provider list and model selector, and the TUI provider picker. In the CLI, the same details are written to the log file; read them with `kilo --print-logs --log-level DEBUG`. + +| Reason | What it means | +|---|---| +| Credentials rejected | The provider rejected your credentials (for example, HTTP 401). Sign in again to refresh them. | +| Not signed in | The provider needs a sign-in before its models load. | +| Couldn't reach the provider | A network error blocked the request. Check your connection and try again. | +| Provider error | The provider returned an unexpected HTTP status. | +| Unexpected response | The provider returned data Kilo Code could not read. | + +When credentials were rejected, Kilo Code offers to sign in again from the same view. + ## Next Steps - **New to Kilo Code?** Start with the [Kilo Code provider](/docs/ai-providers/kilocode) - no setup required