browser-use · MagMueller · Sep 9, 2026 · Sep 9, 2026
diff --git a/docs/README.md b/docs/README.md
@@ -6,9 +6,13 @@ The public site is built from this directory on `main`.
 
 Mintlify generates `/llms.txt` and `/llms-full.txt` from the documentation and navigation. Do not check in static copies: they override the managed files and become stale. Site-wide AI guidance lives in `markdown.instructions` in `docs.json`. Put detailed guidance in navigable MDX pages so it appears in both human docs and AI exports.
 
-The former `/cloud/llms*.txt` and `/open-source/llms*.txt` URLs serve small compatibility indexes linking to the managed root exports, which cover both products. Mintlify serves `.txt` assets through a static handler that bypasses page redirects; keep these pointers, not duplicated documentation bundles. Use `/llms.txt` for new links. Bux is retired; its old documentation routes redirect to the current product guide.
+Use `/llms.txt` for the current index and `/.well-known/llms-full.txt` for the managed full bundle. Mintlify supports both root and `.well-known` managed exports on this site. Full bundles may be cached for up to 24 hours; use the index and individual `.md` pages when freshness matters.
 
-After publishing, check the normal public URLs (without relying only on a preview): `/llms.txt`, `/llms-full.txt`, the scoped compatibility indexes, and the changed `.md` pages. Mintlify or CDN caches can delay visibility.
+Do not restore `/cloud/llms*.txt` or `/open-source/llms*.txt` as static files. This site uses Mintlify Pro, while static `.txt` asset publishing requires Enterprise. Preview assets can work even though production retains a legacy asset. Page redirects also bypass these static routes. Old scoped URLs still serving historical files require Mintlify-side cleanup; neither a normal deploy nor the manual rebuild on September 9 refreshed them. The supported managed exports avoid this limitation without a plan change.
+
+Bux is retired; its old documentation routes redirect to the current product guide.
+
+After publishing, check the normal public URLs (without relying only on a preview): `/llms.txt`, `/.well-known/llms-full.txt`, the Bux redirects, and the changed `.md` pages. Mintlify or CDN caches can delay visibility.
 
 ## Validation
 

diff --git a/docs/cloud/llms-full.txt b/docs/cloud/llms-full.txt
diff --git a/docs/cloud/llms.txt b/docs/cloud/llms.txt
diff --git a/docs/cloud/vibecoding.mdx b/docs/cloud/vibecoding.mdx
@@ -12,4 +12,6 @@ https://docs.browser-use.com/llms.txt
 
 Ask it to use the **Cloud** pages and **API V4** for a new hosted agent integration. The open-source library has a separate API.
 
-The index links to Markdown pages and API specifications. For a single bundle of documentation, use [llms-full.txt](https://docs.browser-use.com/llms-full.txt). Both exports update with the documentation and include guidance on [concurrency](/cloud/guides/concurrency) and [billing](/cloud/guides/billing).
+The index links to Markdown pages and API specifications. For a single bundle of documentation, use [llms-full.txt](https://docs.browser-use.com/.well-known/llms-full.txt). These managed exports include guidance on [concurrency](/cloud/guides/concurrency) and [billing](/cloud/guides/billing).
+
+Full bundles can be cached for up to 24 hours. For the freshest guidance, have your agent follow the index to the linked `.md` pages. Use these managed exports instead of the older `/cloud/llms*.txt` or `/open-source/llms*.txt` URLs.
diff --git a/docs/docs.json b/docs/docs.json
@@ -1175,6 +1175,7 @@
   "description": "Documentation for Browser Use Cloud Agent and Browser APIs, and the separate open-source Python library.",
   "markdown": {
     "instructions": [
+      "Use https://docs.browser-use.com/llms.txt and its linked .md pages for current documentation. The managed full bundle is https://docs.browser-use.com/.well-known/llms-full.txt and can be cached for up to 24 hours. Do not use the obsolete /cloud/llms*.txt or /open-source/llms*.txt static exports.",
       "Choose Cloud API V4 for new agent integrations; V2 is the lower-cost option for simple tasks. Keep V3 examples explicitly versioned. The open-source browser-use library and hosted browser-use-sdk have different APIs.",
       "Cloud authentication uses X-Browser-Use-API-Key, without a Bearer prefix. Install or upgrade browser-use-sdk and use its explicit v4 import for V4. Check the published OpenAPI reference for request fields; do not invent SDK support for new fields.",
       "Cloud concurrency and HTTP request rate are separate. Read GET /api/v2/billing/account for the key’s projectId, concurrentSessionLimit, activeSessionCount, and credit balance, including when using V4. Keys in one project share capacity and credits; rateLimit is a legacy concurrency alias, not requests per second.",

diff --git a/docs/open-source/llms-full.txt b/docs/open-source/llms-full.txt
diff --git a/docs/open-source/llms.txt b/docs/open-source/llms.txt