Rename AI onboarding docs to Agent Toolkit by Alek99 · Pull Request #6510 · reflex-dev/reflex

Alek99 · 2026-05-14T20:22:23Z

Summary

rename the AI onboarding docs page and generated markdown asset to Agent Toolkit, with redirects and a legacy markdown alias for the old slug
update AI docs nav, marketing links, llms.txt grouping, and tests to use Agent Toolkit
surface the Enterprise Event Handler API Plugin in the Enterprise overview, docs landing page, and sidebar under Plugins

Validation

uv run --project docs/app pytest tests/test_agent_files.py tests/test_routes.py
git diff --check
local docs screenshots captured for Agent Toolkit and Enterprise plugin pages

Alek99 · 2026-05-14T20:26:28Z

Proof screenshots from the local docs preview:

Agent Toolkit page: https://files.catbox.moe/5ghkfh.png
Enterprise overview showing plugin discoverability: https://files.catbox.moe/gjooz5.png
Event Handler API Plugin page/sidebar: https://files.catbox.moe/l9w6u3.png

codspeed-hq · 2026-05-14T20:28:41Z

Merging this PR will improve performance by 4.28%

⚠️

Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 1 improved benchmark
✅ 25 untouched benchmarks
⏩ 8 skipped benchmarks¹

Performance Changes

	Benchmark	`BASE`	`HEAD`	Efficiency
⚡	`test_collect_imports[_complicated_page]`	1.6 ms	1.5 ms	+4.28%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

_{Comparing codex/agent-toolkit-docs (798242f) with main (fffe161)}

8 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

picklelo

agent toolkit changes look good.

For the event handler plugin - it was more the discoverability of the page rather than the contents. Let's maybe merge just the agent toolkit changes first and figure out the best UX / naming / search for the event handler plugin

Alek99 · 2026-05-14T20:34:47Z

Updated this to keep only the Agent Toolkit rename/searchability changes. I removed the Event Handler API Plugin discoverability/content changes from this PR so we can handle that UX/naming/search path separately.\n\nValidation: uv run --project docs/app pytest tests/test_agent_files.py tests/test_routes.py passes (9 passed, same existing pytest config warnings).

greptile-apps · 2026-05-14T22:07:10Z

Greptile Summary

This PR renames the "AI Onboarding" docs section to "Agent Toolkit" across the entire docs site, updating the markdown file, sidebar, nav, footer, llms.txt grouping, and tests.

The old /ai/integrations/ai-onboarding/ URL is covered by an explicit redirect and a legacy .md alias (same content as the new path), ensuring zero broken links for existing users or agents.
The get_config import in _plugin.py was moved from module-level to lazy/local scope inside each function, which correctly aligns the monkeypatch targets in tests from agent_files._plugin.get_config to reflex_base.config.get_config.
The footer link for "Agent Toolkit" is fixed from the wrong /docs/ai/integrations/overview/ URL to the correct /docs/ai/integrations/agent-toolkit/.

Confidence Score: 5/5

Safe to merge — all renamed paths have redirects and legacy aliases in place; no broken external links or route gaps.

The changes are purely a documentation rename with comprehensive backward-compatibility coverage: explicit HTTP redirects for both the /ai/ and /ai-builder/ old slugs, a legacy markdown file alias serving identical content, breadcrumb overrides, and updated tests that now correctly target the lazy-imported get_config. No logic paths or runtime code are affected.

No files require special attention.

Important Files Changed

Filename	Overview
docs/app/agent_files/_plugin.py	Renames AI_ONBOARDING_DOC_PATHS/section to AGENT_TOOLKIT, adds LEGACY_MARKDOWN_ALIASES to emit the old ai-onboarding.md path with identical content, and moves get_config imports to lazy/local scope (fixing monkeypatch target in tests).
docs/app/reflex_docs/reflex_docs.py	Adds explicit redirects for both /ai/integrations/ai-onboarding/ and /ai-builder/integrations/ai-onboarding/ → /ai/integrations/agent-toolkit/ before the generic /ai-builder/ loop, covering all legacy URL variants.
docs/app/tests/test_agent_files.py	Updates test fixtures/assertions to use agent-toolkit paths, fixes monkeypatch targets from agent_files._plugin.get_config to reflex_base.config.get_config (correct now that the import is lazy), and adds an alias-equality assertion.
docs/app/tests/test_routes.py	Verifies agent-toolkit is a route, ai-onboarding is not, and no /ai-builder/ prefix routes exist for either slug.
packages/reflex-site-shared/src/reflex_site_shared/views/footer.py	Fixes the "Agent Toolkit" footer link from the incorrect /docs/ai/integrations/overview/ to the correct /docs/ai/integrations/agent-toolkit/.
packages/reflex-site-shared/src/reflex_site_shared/views/marketing_navbar.py	Updates the navbar href from /docs/ai/integrations/ai-onboarding/ to /docs/ai/integrations/agent-toolkit/.
docs/app/reflex_docs/templates/docpage/docpage.py	Adds "Ai Onboarding" → "Agent Toolkit" breadcrumb override for any residual rendering of the old URL slug.
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py	Renames get_sidebar_items_ai_onboarding/ai_onboarding_items to get_sidebar_items_agent_toolkit/agent_toolkit_items with updated display name and link.

_{Reviews (2): Last reviewed commit: "Merge origin/main into codex/agent-toolk..." | Re-trigger Greptile}

FarhanAliRaza · 2026-05-18T19:35:38Z

+    segment_labels = {
+        "ai": "AI",
+        "ai-onboarding": "Agent Toolkit",
+        "agent-toolkit": "Agent Toolkit",


Nit: this line isn't needed — to_title_case(to_snake_case("agent-toolkit")) already produces "Agent Toolkit", so the fallback handles it. Removing for clarity:

Suggested change

"agent-toolkit": "Agent Toolkit",

…ution # Conflicts: # docs/app/reflex_docs/templates/docpage/docpage.py

FarhanAliRaza · 2026-05-20T18:29:47Z


 def _llms_url_for_path(url_path: Path) -> str:
    """Return the public URL for a generated markdown asset."""
+    from reflex_base.config import get_config


We might want to move it to the top if not for a specific reason.

FarhanAliRaza · 2026-05-20T19:44:58Z

    segments = [segment for segment in path.split("/") if segment and segment != "docs"]
+    segment_labels = {
+        "ai": "AI",
+        "ai-onboarding": "Agent Toolkit",


The slug no longer exists, it redirects to agent-toolkit

FarhanAliRaza · 2026-05-20T19:51:12Z

 ## 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. These Agent Toolkit resources are designed for assistants that need focused Markdown pages, a broad docs index, structured MCP lookup, or repeatable local skills.


These Agent Toolkit resources are designed for assistants that need focused Markdown pages, a broad docs index, structured MCP lookup, or repeatable local skills.

maybe wording can be improved here. Feels too listy.

Resolve conflicts between the Agent Toolkit docs rename and main's docpage/sidebar refactor: - docpage.py: adopt main's module-level _BREADCRUMB_LABEL_OVERRIDES mechanism and add the "Ai Onboarding" -> "Agent Toolkit" entry so the legacy slug still renders the new label; drop the now-redundant local segment_labels dict. - sidebar.py: re-apply the ai_onboarding -> agent_toolkit rename (items, index, slug, category label "Agent Toolkit") on top of main's rewritten sidebar. - test_agent_files.py: keep patching reflex_base.config.get_config to match the PR's inline get_config imports in _plugin.py (main had switched the patch target to the module attribute, which no longer exists). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HCAERc8aspQq5TZr7WJ9fX

picklelo reviewed May 14, 2026

View reviewed changes

Rename AI onboarding docs to Agent Toolkit

7ca8d91

Alek99 force-pushed the codex/agent-toolkit-docs branch from af072f6 to 7ca8d91 Compare May 14, 2026 20:34

Alek99 marked this pull request as ready for review May 14, 2026 22:03

Alek99 requested a review from a team as a code owner May 14, 2026 22:03

Alek99 requested a review from picklelo May 14, 2026 22:03

FarhanAliRaza previously approved these changes May 18, 2026

View reviewed changes

Merge remote-tracking branch 'origin/main' into pr6510-conflict-resol…

5f60036

…ution # Conflicts: # docs/app/reflex_docs/templates/docpage/docpage.py

Alek99 dismissed FarhanAliRaza’s stale review via 5f60036 May 20, 2026 17:58

Alek99 changed the title ~~[codex] Rename AI onboarding docs to Agent Toolkit~~ Rename AI onboarding docs to Agent Toolkit May 20, 2026

Simplify breadcrumb label mapping

d2b7639

FarhanAliRaza reviewed May 20, 2026

View reviewed changes

adhami3310 added the documentation Improvements or additions to documentation label Jun 24, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Rename AI onboarding docs to Agent Toolkit#6510

Rename AI onboarding docs to Agent Toolkit#6510
Alek99 wants to merge 4 commits into
mainfrom
codex/agent-toolkit-docs

Alek99 commented May 14, 2026

Uh oh!

Alek99 commented May 14, 2026

Uh oh!

codspeed-hq Bot commented May 14, 2026 •

edited

Loading

Uh oh!

picklelo left a comment

Uh oh!

Alek99 commented May 14, 2026

Uh oh!

greptile-apps Bot commented May 14, 2026 •

edited

Loading

Uh oh!

FarhanAliRaza May 18, 2026

Uh oh!

FarhanAliRaza May 20, 2026

Uh oh!

FarhanAliRaza May 20, 2026

Uh oh!

FarhanAliRaza May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

Alek99 commented May 14, 2026

Summary

Validation

Uh oh!

Alek99 commented May 14, 2026

Uh oh!

codspeed-hq Bot commented May 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will improve performance by 4.28%

Performance Changes

Footnotes

Uh oh!

picklelo left a comment

Choose a reason for hiding this comment

Uh oh!

Alek99 commented May 14, 2026

Uh oh!

greptile-apps Bot commented May 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Uh oh!

FarhanAliRaza May 18, 2026

Choose a reason for hiding this comment

Uh oh!

FarhanAliRaza May 20, 2026

Choose a reason for hiding this comment

Uh oh!

FarhanAliRaza May 20, 2026

Choose a reason for hiding this comment

Uh oh!

FarhanAliRaza May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

codspeed-hq Bot commented May 14, 2026 •

edited

Loading

greptile-apps Bot commented May 14, 2026 •

edited

Loading