🤖📚 FR: Local Docs Bundle - Stop Making Me Download 2MB to Learn What `/agents` Does 🐌💸
Status Fixed / completed
Maintainer reply ✓ Yes — catherinewu
Workaround ✓ Mentioned in description ↑
Activity 9 comments · opened Jul 25, 2025 · closed Nov 29, 2025
💡 Likely answer: A maintainer (catherinewu, contributor)
responded on this thread — see the highlighted reply below.
Summary
Currently, Claude Code fetches documentation from the web every time I ask about features, resulting in slow 2MB requests to load a doc homepaeg that don't even contain the specific information I need. This is inefficient, expensive, and frankly embarrassing for an AI coding tool.
Problem
- Asked about the new
/agentscommand - Claude Code made a 2MB web request to the docs homepage
- Still couldn't find the actual
/agentsdocumentation - Wasted time, tokens, and bandwidth for zero useful information
Proposed Solution
Bundle local documentation with Claude Code updates
- Ship docs as local files that update with each Claude Code version
- Instant access to accurate, version-matched documentation
- No more web requests for basic feature documentation
- No more "I can't find that in the 2MB homepage I just downloaded"
Benefits
- ⚡ Instant access - No network latency
- 💰 Cost efficient - No repeated web requests
- 🎯 Always accurate - Docs match your Claude Code version
- 🔒 Works offline - No internet dependency for docs
- 🧠 Better UX - Claude actually knows what features exist
Current Workaround
Manually reading web docs while Claude Code pretends it can help with documentation queries.
Expected Behavior
user: how does /agents work?
claude: *instantly accesses local docs* The /agents command allows you to...Not:
user: how does /agents work?
claude: *downloads entire internet* I fetched 2MB but still don't know 🤷♂️---
This feels like a no-brainer feature that should have shipped with v1. Please make Claude Code actually know what Claude Code does. Sincerely, a developer who asked a simple question and somehow triggered a bandwidth apocalypse. 🤖💔
9 Comments
PS. FR written by Claude not me
This can be attained using a hook to maintain a version of the doc in a given location and by for example:
Is that workable if new pages are being added to the docs?
I guess so, by recursively downloading the whole doc?
There's a project created by @ericbuess that does this - it creates a
/docscommand a hook that auto-fetches the Claude Code docs.But I agree, this should be baked into Claude Code itself, natively.
https://github.com/ericbuess/claude-code-docs
Although it doesn't work on macos currently... exactly why this needs to be native.
As another example, it seems insane to be that Claude Code doesn't know how to use itself. I shouldn't be having to teach it syntax... it should just know.... surely....
<img width="737" height="217" alt="Image" src="https://github.com/user-attachments/assets/657bdae1-a414-4c9b-a1fe-0dd6be7d1329" />
Hi, we now have a claude-code-guide subagent pre-installed in claude code that is able to look up docs and tell you accurate information about how to use claude code and claude agent sdk. thanks for reporting!
<img width="552" height="502" alt="Image" src="https://github.com/user-attachments/assets/b3648d24-5563-4611-98b6-d0c4a8935271" />
love it! thank you 🙇
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.