Feature request for product/service
Indexing
Describe the request
Index Local Docs (Files) as First-Class Knowledge — Not Just Web Pages
Summary
Add indexing for local project documentation (e.g. docs/, README.md, markdown) and treat it like web docs. The AI would then consistently use internal project docs, onboarding guides, and architecture notes.
Why this matters (from a power user)
I’ve felt this gap since July–August 2025 — about 8 months. I’m a heavy Cursor user (top ~10% token usage). Despite docs/ and .cursor/rules/, the AI still under-uses or ignores project docs unless I manually point it at them. The “read docs first” instruction only works if those docs are surfaced automatically. Right now they aren’t.
Current behavior
Doc indexing (Context7, external knowledge bases, etc.) focuses on web sources. Local project docs in docs/, markdown, and internal notes are just regular files. They’re not indexed or retrieved as dedicated knowledge, so the AI often skips them even when they exist.
Desired behavior
Add per-project local doc indexing:
Source selection – Patterns like docs/**/.md, README.md, .cursor/rules/*.mdc
Automatic indexing – Index updates when tracked files change
Context integration – Local docs are retrieved and cited like web docs
Project-only – Docs stay in the current project; no cross-workspace sharing unless configured
Benefits
Onboarding – New devs and the AI get consistent answers from docs/, README, and guides
Large codebases – Reliable use of architecture, conventions, and runbooks
Rules + docs together – .cursor/rules/ and docs/ become one indexed documentation layer
Offline/private – Internal or sensitive docs stay local without web indexing
Use cases
docs/System-Guide.md → AI follows system patterns when editing
docs/guides/*-patterns.md → AI follows patterns from these guides
README.md + docs/onboarding/ → Onboarding and overview consistently inform answers
Possible implementation
Reuse/extend existing indexing (chunking, embeddings, retrieval)
Project setting: “local_docs”: [“docs/”, “README.md”] (similar to Context7)
Optional project toggle to enable/disable local doc indexing
Screenshot / Screen Recording
Operating System (if it applies)
Windows 10/11
MacOS
Linux