Rename AI onboarding docs to Agent Toolkit (#6510)

* Rename AI onboarding docs to Agent Toolkit

* Simplify breadcrumb label mapping

* address review: top-level get_config import, drop dead breadcrumb override, reword toolkit intro

* address review: accurate tabs intro, drop redundant manual title

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Farhan <www.mfarvirus@gmail.com>

Author: 3 people

README.md

@@ -24,7 +24,7 @@
 > Build faster with Reflex:
 >
 > - **[AI Builder](https://build.reflex.dev/)** - Generate full-stack Reflex apps in seconds.
-> - **[Agent Toolkit](https://reflex.dev/docs/ai/integrations/ai-onboarding/)** - Connect MCP and Skills to your coding assistant.
+> - **[Agent Toolkit](https://reflex.dev/docs/ai/integrations/agent-toolkit/)** - Connect MCP and Skills to your coding assistant.
 > - **[App Management](https://reflex.dev/hosting)** - Deploy and manage your Reflex apps.
 
 ---

docs/ai_builder/features/agent_toolkit.md

@@ -42,4 +42,4 @@ Skills add reusable Reflex-specific workflows to a local coding assistant. The A
 
 Use MCP for current structured documentation and component context. Use Skills for repeatable setup, development, validation, and debugging behavior. They can be used together.
 
-For the complete onboarding workflow, see [AI Onboarding](/docs/ai/integrations/ai-onboarding/).
+For the complete onboarding workflow, see the [Agent Toolkit guide](/docs/ai/integrations/agent-toolkit/).

…ai_builder/integrations/ai_onboarding.md …ai_builder/integrations/agent_toolkit.mddocs/ai_builder/integrations/ai_onboarding.md renamed to docs/ai_builder/integrations/agent_toolkit.md docs/ai_builder/integrations/ai_onboarding.md renamed to docs/ai_builder/integrations/agent_toolkit.md

@@ -1,4 +1,4 @@
-# AI Onboarding
+# Agent Toolkit
 
 ```python exec
 import reflex as rx
@@ -20,7 +20,7 @@ def _resource_card(
     )
 
 
-def onboarding_resources() -> rx.Component:
+def agent_toolkit_resources() -> rx.Component:
     return rx.el.div(
         _resource_card(
             "Docs for Agents",
@@ -51,12 +51,10 @@ def onboarding_resources() -> rx.Component:
     )
 ```
 
-Everything you need to onboard your AI coding assistant to Reflex.
-
-If you are building Reflex apps with AI, combine current docs, structured MCP context, and local skills so the assistant can plan, code, run, and debug with the same assumptions as the Reflex docs.
+The Agent Toolkit gives AI coding assistants the Reflex context they need to plan, code, run, and debug with the same assumptions as the Reflex docs.
 
 ```python eval
-onboarding_resources()
+agent_toolkit_resources()
 ```
 
 ## Prerequisite: Choose Your Workflow
@@ -71,7 +69,7 @@ You do not need an API key to read Reflex documentation. Start by deciding how y
 
 ## Reflex Docs for Agents
 
-You can give your assistant current Reflex documentation in a few ways.
+You can give your assistant current Reflex documentation in a few ways, whether it reads Markdown directly or queries the docs over MCP. Each tab below covers one approach and when to reach for it.
 
 `````md tabs
 
@@ -80,7 +78,7 @@ You can give your assistant current Reflex documentation in a few ways.
 Every docs page has a Markdown version that agents can read directly. Add `.md` to the docs path:
 
 ```text
-https://reflex.dev/docs/ai/integrations/ai-onboarding.md
+https://reflex.dev/docs/ai/integrations/agent-toolkit.md
 ```
 
 Use this when an agent needs one focused page.

docs/ai_builder/integrations/agents_md.md

@@ -89,7 +89,7 @@ cp AGENTS.md /path/to/your/reflex-project/AGENTS.md
 
 ## Combining With Skills and MCP
 
-`AGENTS.md` and `CLAUDE.md` anchor the assistant in your project. Pair them with the other onboarding tools for deeper Reflex knowledge:
+`AGENTS.md` and `CLAUDE.md` anchor the assistant in your project. Pair them with the Agent Toolkit resources for deeper Reflex knowledge:
 
 - [Reflex Agent Skills](/docs/ai/integrations/skills/) provide reusable workflows that the file references by name.
 - [Reflex MCP](/docs/ai/integrations/mcp-overview/) provides structured documentation lookup at runtime.

docs/app/agent_files/_plugin.py

@@ -15,8 +15,11 @@
     "ai/integrations/mcp-installation.md",
     "ai/integrations/mcp-overview.md",
 }
-AI_ONBOARDING_DOC_PATHS = {
-    "ai/integrations/ai-onboarding.md",
+AGENT_TOOLKIT_DOC_PATHS = {
+    "ai/integrations/agent-toolkit.md",
+}
+LEGACY_MARKDOWN_ALIASES = {
+    Path("ai/integrations/ai-onboarding.md"): Path("ai/integrations/agent-toolkit.md"),
 }
 MCP_DOC_ORDER = {
     "ai/integrations/mcp-overview.md": 0,
@@ -187,7 +190,7 @@ def _include_index_entry_in_llms_txt(markdown_file: MarkdownIndexEntry) -> bool:
     path = markdown_file.url_path.as_posix()
     return (
         path in MCP_DOC_PATHS
-        or path in AI_ONBOARDING_DOC_PATHS
+        or path in AGENT_TOOLKIT_DOC_PATHS
         or path in SKILLS_DOC_PATHS
         or not path.startswith("ai/")
         or path.startswith("ai/overview/")
@@ -197,8 +200,8 @@ def _include_index_entry_in_llms_txt(markdown_file: MarkdownIndexEntry) -> bool:
 def _section_for_path(url_path: Path) -> str:
     """Return the llms.txt section for a generated markdown asset."""
     path = url_path.as_posix()
-    if path in AI_ONBOARDING_DOC_PATHS:
-        return "AI Onboarding"
+    if path in AGENT_TOOLKIT_DOC_PATHS:
+        return "Agent Toolkit"
     if path in MCP_DOC_PATHS:
         return "MCP"
     if path in SKILLS_DOC_PATHS:
@@ -216,10 +219,10 @@ def _ordered_sections(
     if "AI Builder" in sections and "MCP" in sections:
         ordered_sections.remove("MCP")
         ordered_sections.insert(ordered_sections.index("AI Builder") + 1, "MCP")
-    if "AI Builder" in sections and "AI Onboarding" in sections:
-        ordered_sections.remove("AI Onboarding")
+    if "AI Builder" in sections and "Agent Toolkit" in sections:
+        ordered_sections.remove("Agent Toolkit")
         ordered_sections.insert(
-            ordered_sections.index("AI Builder") + 1, "AI Onboarding"
+            ordered_sections.index("AI Builder") + 1, "Agent Toolkit"
         )
     if "MCP" in sections and "Skills" in sections:
         ordered_sections.remove("Skills")
@@ -844,9 +847,16 @@ def generate_agent_files() -> tuple[tuple[Path, str | bytes], ...]:
         (entry.url_path, generate_markdown_file_content(entry))
         for entry in markdown_file_entries
     )
+    markdown_files_by_path = dict(markdown_files)
+    legacy_markdown_files = tuple(
+        (legacy_path, markdown_files_by_path[target_path])
+        for legacy_path, target_path in LEGACY_MARKDOWN_ALIASES.items()
+        if target_path in markdown_files_by_path
+    )
 
     all_markdown_files = [
         *markdown_files,
+        *legacy_markdown_files,
         *dynamic_api_reference_files,
     ]
 

docs/app/reflex_docs/reflex_docs.py

@@ -172,9 +172,13 @@ def _canonical_url(path: str) -> str:
 
 # Add redirects.
 redirects = [
-    (route.path.replace("/ai/", "/ai-builder/", 1), route.path)
-    for route in routes
-    if route.path.startswith("/ai/")
+    ("/ai/integrations/ai-onboarding/", "/ai/integrations/agent-toolkit/"),
+    ("/ai-builder/integrations/ai-onboarding/", "/ai/integrations/agent-toolkit/"),
+    *[
+        (route.path.replace("/ai/", "/ai-builder/", 1), route.path)
+        for route in routes
+        if route.path.startswith("/ai/")
+    ],
 ]
 redirects.extend([
     ("/ai/features/ide/", "/ai/features/editor-modes/"),

docs/app/reflex_docs/templates/docpage/sidebar/sidebar.py

@@ -13,9 +13,9 @@
 from reflex_site_shared.components.docs_shell import docs_sidebar_leaf as sidebar_leaf
 
 from .sidebar_items.ai import (
+    agent_toolkit_items,
     ai_builder_integrations,
     ai_builder_overview_items,
-    ai_onboarding_items,
     mcp_items,
     skills_items,
 )
@@ -234,7 +234,7 @@ def append_to_items(items, flat_items):
     + recipes
     + ai_builder_overview_items
     + ai_builder_integrations
-    + ai_onboarding_items
+    + agent_toolkit_items
     + mcp_items
     + skills_items
     + api_reference
@@ -324,7 +324,7 @@ def sidebar_comp(
     recipes_index: rx.vars.ArrayVar[list[int]],
     enterprise_usage_index: rx.vars.ArrayVar[list[int]],
     enterprise_component_index: rx.vars.ArrayVar[list[int]],
-    ai_onboarding_index: rx.vars.ArrayVar[list[int]],
+    agent_toolkit_index: rx.vars.ArrayVar[list[int]],
     mcp_index: rx.vars.ArrayVar[list[int]],
     skills_index: rx.vars.ArrayVar[list[int]],
     ai_builder_overview_index: rx.vars.ArrayVar[list[int]],
@@ -348,7 +348,7 @@ def sidebar_comp(
     is_docs_hosting = url.startswith("/hosting/")
     is_docs_ai_builder = url.startswith("/ai/")
     is_ai_mcp_or_skills = (
-        url.startswith("/ai/integrations/ai-onboarding/")
+        url.startswith("/ai/integrations/agent-toolkit/")
         | url.startswith("/ai/integrations/skills/")
         | url.startswith("/ai/integrations/agents-md/")
         | url.startswith("/ai/integrations/mcp")
@@ -387,8 +387,8 @@ def sidebar_comp(
             ~is_ai_mcp_or_skills,
         ),
         sidebar_category(
-            "MCP/Skills",
-            ai_builder_pages.integrations.ai_onboarding.path,
+            "Agent Toolkit",
+            ai_builder_pages.integrations.agent_toolkit.path,
             "plug",
             is_ai_mcp_or_skills,
         ),
@@ -397,9 +397,9 @@ def sidebar_comp(
     ai_mcp_skills_content = rx.el.ul(
         create_sidebar_section(
             "Overview",
-            ai_builder_pages.integrations.ai_onboarding.path,
-            ai_onboarding_items,
-            ai_onboarding_index,
+            ai_builder_pages.integrations.agent_toolkit.path,
+            agent_toolkit_items,
+            agent_toolkit_index,
             url,
         ),
         create_sidebar_section(
@@ -647,7 +647,7 @@ def sidebar(url=None, width: str = "100%") -> rx.Component:
             enterprise_component_index=calculate_index(
                 enterprise_component_items, normalized_url
             ),
-            ai_onboarding_index=calculate_index(ai_onboarding_items, normalized_url),
+            agent_toolkit_index=calculate_index(agent_toolkit_items, normalized_url),
             ai_builder_overview_index=calculate_index(
                 ai_builder_overview_items, normalized_url
             ),

docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py

@@ -172,13 +172,13 @@ def get_ai_builder_integrations():
     ]
 
 
-def get_sidebar_items_ai_onboarding():
+def get_sidebar_items_agent_toolkit():
     from reflex_docs.pages.docs import ai_builder
 
     return [
         SideBarItem(
-            names="AI Onboarding",
-            link=ai_builder.integrations.ai_onboarding.path,
+            names="Agent Toolkit",
+            link=ai_builder.integrations.agent_toolkit.path,
         ),
     ]
 
@@ -215,6 +215,6 @@ def get_sidebar_items_skills():
 
 ai_builder_overview_items = get_sidebar_items_ai_builder_overview()
 ai_builder_integrations = get_ai_builder_integrations()
-ai_onboarding_items = get_sidebar_items_ai_onboarding()
+agent_toolkit_items = get_sidebar_items_agent_toolkit()
 mcp_items = get_sidebar_items_mcp()
 skills_items = get_sidebar_items_skills()

docs/app/tests/test_agent_files.py

@@ -58,9 +58,9 @@ def test_generate_llms_txt_groups_docs_at_public_root(monkeypatch):
             section="MCP",
         ),
         MarkdownIndexEntry(
-            url_path=Path("ai/integrations/ai-onboarding.md"),
-            title="AI Onboarding",
-            section="AI Onboarding",
+            url_path=Path("ai/integrations/agent-toolkit.md"),
+            title="Agent Toolkit",
+            section="Agent Toolkit",
         ),
         MarkdownIndexEntry(
             url_path=Path("ai/integrations/mcp-installation.md"),
@@ -103,9 +103,9 @@ def test_generate_llms_txt_groups_docs_at_public_root(monkeypatch):
     )
     assert "Resend Integration" not in content
     assert "Code and Review" not in content
-    assert "### AI Onboarding\n\n" in content
+    assert "### Agent Toolkit\n\n" in content
     assert (
-        "- [AI Onboarding](https://reflex.dev/docs/ai/integrations/ai-onboarding.md)"
+        "- [Agent Toolkit](https://reflex.dev/docs/ai/integrations/agent-toolkit.md)"
         in content
     )
     assert "### MCP\n\n" in content
@@ -119,8 +119,8 @@ def test_generate_llms_txt_groups_docs_at_public_root(monkeypatch):
     )
     assert "### Skills\n\n" in content
     assert "- [Skills](https://reflex.dev/docs/ai/integrations/skills.md)" in content
-    assert content.index("### AI Builder") < content.index("### AI Onboarding")
-    assert content.index("### AI Onboarding") < content.index("### MCP")
+    assert content.index("### AI Builder") < content.index("### Agent Toolkit")
+    assert content.index("### Agent Toolkit") < content.index("### MCP")
     assert content.index("### MCP") < content.index("### Skills")
     assert content.index("mcp-overview.md") < content.index("mcp-installation.md")
 
@@ -373,6 +373,10 @@ def test_generate_agent_files_emits_trailing_slash_variants():
         path for path in files if path.suffix == ".md" and path.name != ".md"
     ]
     assert markdown_paths, "expected at least one markdown asset"
+    assert (
+        files[Path("ai/integrations/ai-onboarding.md")]
+        == files[Path("ai/integrations/agent-toolkit.md")]
+    )
 
     for path in markdown_paths:
         twin = markdown_path_for_trailing_slash_url(path)

docs/app/tests/test_routes.py

@@ -45,11 +45,13 @@ def test_ai_builder_routes_use_ai_prefix(routes_fixture):
     paths = {route.path for route in routes_fixture if route.path}
 
     assert "/ai/overview/best-practices/" in paths
-    assert "/ai/integrations/ai-onboarding/" in paths
+    assert "/ai/integrations/agent-toolkit/" in paths
     assert "/ai/integrations/mcp-overview/" in paths
     assert "/ai/integrations/skills/" in paths
+    assert "/ai/integrations/ai-onboarding/" not in paths
     assert "/ai-builder/overview/best-practices/" not in paths
     assert "/ai-builder/integrations/ai-onboarding/" not in paths
+    assert "/ai-builder/integrations/agent-toolkit/" not in paths
     assert "/ai-builder/integrations/mcp-overview/" not in paths
     assert "/ai-builder/integrations/skills/" not in paths