crewai - ✅(Solved) Fix [BUG] Doc update [1 pull requests, 1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
crewAIInc/crewAI#5253Fetched 2026-04-08 02:43:11
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
cross-referenced ×2commented ×1labeled ×1referenced ×1

Root Cause

Fix Action

Fixed

PR fix notes

PR #5254: fix: update outdated CrewAI Toolkit links in docs (fixes #5253)

Description (problem / solution / changelog)

Summary

Replaces all references to the deprecated personal repo URL (github.com/joaomdmoura/crewai-tools) with the current monorepo location (github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools) across all 4 language versions of the docs (en, ko, ar, pt-BR). Affected files: agents.mdx, tasks.mdx, and tools.mdx in each locale — 12 files total.

Adds a regression test (lib/crewai/tests/test_docs_links.py) that scans all .mdx files for the deprecated URL to prevent this from recurring.

Fixes #5253

Review & Testing Checklist for Human

  • Verify the new link https://github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools resolves correctly
  • Spot-check a couple of the localized doc files (ar, ko, pt-BR) to confirm the links render properly in markdown context
  • Note: test_crewai_toolkit_links_use_correct_url uses a regex matching CrewAI.*Toolkit in link text, which won't match localized link text (e.g., Arabic مجموعة أدوات CrewAI). The first test (test_no_deprecated_crewai_tools_link) does a plain string search and covers all languages. Decide if the second test's partial coverage is acceptable or if it should be adjusted.

Notes

  • Changelog entries referencing @joaomdmoura as an author attribution were intentionally left unchanged — those are accurate historical records, not links to the old repo.
  • The ko/concepts/tools.mdx diff includes a trailing newline fix (missing EOF newline).

Link to Devin session: https://app.devin.ai/sessions/8f3a0917988f4a48846744a720484b0f

<!-- CURSOR_SUMMARY -->

[!NOTE] Low Risk Low risk: documentation-only link updates plus a new test that scans .mdx files for deprecated URLs; no runtime code paths are affected beyond CI test coverage.

Overview Updates all docs references to the CrewAI Toolkit repo from github.com/joaomdmoura/crewai-tools to the monorepo location github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools across multiple locales (e.g., agents.mdx, tasks.mdx, tools.mdx).

Adds lib/crewai/tests/test_docs_links.py, a pytest suite that walks the docs/ tree to fail CI on deprecated toolkit URLs and to validate that markdown links labeled CrewAI Toolkit point at the correct monorepo URL.

<sup>Written by Cursor Bugbot for commit f66e30b7b7447d63544252022ae638bfbdb24057. This will update automatically on new commits. Configure here.</sup>

<!-- /CURSOR_SUMMARY -->

Changed files

  • docs/ar/concepts/agents.mdx (modified, +1/-1)
  • docs/ar/concepts/tasks.mdx (modified, +1/-1)
  • docs/ar/concepts/tools.mdx (modified, +1/-1)
  • docs/en/concepts/agents.mdx (modified, +1/-1)
  • docs/en/concepts/tasks.mdx (modified, +1/-1)
  • docs/en/concepts/tools.mdx (modified, +1/-1)
  • docs/ko/concepts/agents.mdx (modified, +1/-1)
  • docs/ko/concepts/tasks.mdx (modified, +1/-1)
  • docs/ko/concepts/tools.mdx (modified, +2/-2)
  • docs/pt-BR/concepts/agents.mdx (modified, +1/-1)
  • docs/pt-BR/concepts/tasks.mdx (modified, +1/-1)
  • docs/pt-BR/concepts/tools.mdx (modified, +1/-1)
  • lib/crewai/tests/test_docs_links.py (added, +85/-0)
RAW_BUFFERClick to expand / collapse

Description

The https://docs.crewai.com/en/concepts/agents#agent-tools ---> CrewAI Toolkit should be https://github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools/src/crewai_tools

Steps to Reproduce

NA

Expected behavior

Show the right link

Screenshots/Code snippets

NA

Operating System

Ubuntu 20.04

Python Version

3.10

crewAI Version

NA

crewAI Tools Version

NA

Virtual Environment

Venv

Evidence

NA

Possible Solution

NA

Additional context

NA

extent analysis

TL;DR

Update the link in the documentation to point to the correct repository location.

Guidance

  • Verify the correct repository URL is https://github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools/src/crewai_tools.
  • Update the documentation at https://docs.crewai.com/en/concepts/agents#agent-tools to reflect the correct link.
  • Confirm that the update is visible and accurate after making the change.
  • Consider notifying relevant teams or stakeholders about the update to ensure consistency across all documentation and resources.

Notes

The solution assumes that the correct repository location is indeed https://github.com/crewAIInc/crewAI/tree/main/lib/crewai-tools/src/crewai_tools as provided in the issue.

Recommendation

Apply workaround: Update the link in the documentation, as this directly addresses the issue described and ensures users are directed to the correct resource.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Show the right link

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING