diff --git a/packages/kilo-docs/pages/ai-providers/index.md b/packages/kilo-docs/pages/ai-providers/index.md
index a087c489533..99602c3623b 100644
--- a/packages/kilo-docs/pages/ai-providers/index.md
+++ b/packages/kilo-docs/pages/ai-providers/index.md
@@ -61,6 +61,10 @@ Route requests through unified APIs with additional features:
 All API keys use VS Code's Secret Storage—never stored in plain text.
 {% /callout %}
 
+{% callout type="warning" title="Time-to-first-byte timeout" %}
+For all providers, there is a **five-minute timeout** on time to first byte. This means if a provider does not begin streaming a response within five minutes of the request being sent, the request will be cancelled. This is an intrinsic constraint of the Bun runtime and cannot be configured.
+{% /callout %}
+
 ## Next Steps
 
 - **New to Kilo Code?** Start with the [Kilo Code provider](/docs/ai-providers/kilocode) - no setup required