docmancer
Docmancer compresses documentation context so coding agents spend tokens on code, not on rereading raw docs. It ingests local files, fetches public docs, indexes everything locally with SQLite FTS5, and returns compact context packs with source attribution. The core retrieval path needs no API keys, vector database, hosted query API, or background daemon.
Executable: {{DOCS_KIT_CMD}}
All commands below use docmancer as shorthand for the full executable path above.
When to Use
- User asks about a third-party library, SDK, or API and you need accurate documentation.
- User references docs from a public site, GitHub repository, or local files.
- You need to verify version-specific API behavior or exact method signatures.
- User asks you to search or query previously indexed documentation.
Workflow
- Run
docmancer list to see indexed docs.
- Run
docmancer query "question" when relevant docs are present.
- If local docs are missing and the user approves the path, run
docmancer ingest <path>.
- If URL docs are missing and the user approves the source, run
docmancer add <url>.
- Use the returned sections as source-grounded context for the answer or code change.
Ingest Local Documentation
docmancer ingest ./docs
Use ingest for local files and directories.
| Flag |
Purpose |
--include <glob> |
Include only matching relative paths |
--exclude <glob> |
Exclude matching relative paths |
--format <format> |
Restrict to formats such as md, txt, pdf, docx, rtf, or html |
--recursive / --no-recursive |
Recurse through directories |
--skip-known |
Skip files whose content hash is already indexed |
--ocr mistral |
Extract markdown from PDFs and images with Mistral OCR before indexing (requires MISTRAL_API_KEY) |
--recreate |
Drop and rebuild the index; when vector sync is enabled, drops the vector collection first so embedder or dimension changes rebuild cleanly |
An OKF bundle (a directory of markdown files with YAML frontmatter, produced by docmancer memory export --format okf or another OKF tool) can be ingested directly: reserved index.md / log.md files are skipped and type / tags / timestamp frontmatter is lifted into the index.
Add URL Documentation
docmancer add https://docs.example.com
Use add for documentation URLs and GitHub repositories.
| Flag |
Purpose |
--provider <auto|gitbook|mintlify|web|github> |
Force a specific provider |
--strategy <strategy> |
Force discovery strategy (llms-full.txt, sitemap.xml, nav-crawl) |
--max-pages <n> |
Cap pages fetched |
--browser |
Playwright fallback for JS-heavy sites |
--recreate |
Drop and rebuild the index |
Query Documentation
docmancer query "<question>"
Primary command. Returns a compact markdown context pack with source attribution and token savings.
| Flag |
Purpose |
--budget <n> |
Max estimated output tokens |
--limit <n> |
Max sections to return |
--expand |
Include adjacent sections around matches |
--expand page |
Include the full matching page within the budget |
--format <markdown|json> |
Output format |
--allow-degraded |
In dense, sparse, or hybrid modes, fall back to remaining signals (for example lexical) when vector retrieval fails instead of exiting with an error |
Manage Sources
| Command |
Purpose |
docmancer list |
Show indexed documentation sources |
docmancer list --all |
Show every stored page or file |
docmancer inspect |
Show index stats, format counts, and extract locations |
docmancer update [source] |
Re-fetch and re-index all sources, or one specific source |
docmancer remove <source> |
Remove a source or docset root |
docmancer remove --all |
Clear the entire index |
docmancer clear |
Wipe docmancer home, model caches used by docmancer, and managed Qdrant data (destructive; use --dry-run, --keep-config, or --keep-models as needed) |
docmancer doctor |
Check config, loader availability, index health, and installed skills |
docmancer fetch <url> --output <dir> |
Download docs to markdown without indexing (add --format okf for an OKF bundle) |
Common Mistakes
- Do not use
docmancer add for new local files. Use docmancer ingest <path>.
- Do not use
docmancer ingest for URLs. Use docmancer add <url>.
- Do not run
docmancer query before checking indexed sources with docmancer list.
- Do not assume docs are indexed. Always verify with
docmancer list before querying.
Source: docmancer/docmancer — distributed by TomeVault.
1---2name: docmancer3description: Search local documentation context packs with docmancer CLI. Use when the user asks about library docs, API references, vendor docs, version-specific behavior, offline docs, or wants to add docs before answering a technical question. Use when this capability is needed.4---56# docmancer78Docmancer compresses documentation context so coding agents spend tokens on code, not on rereading raw docs. It ingests local files, fetches public docs, indexes everything locally with SQLite FTS5, and returns compact context packs with source attribution. The core retrieval path needs no API keys, vector database, hosted query API, or background daemon.910Executable: `{{DOCS_KIT_CMD}}`1112**All commands below use `docmancer` as shorthand for the full executable path above.**1314## When to Use1516- User asks about a third-party library, SDK, or API and you need accurate documentation.17- User references docs from a public site, GitHub repository, or local files.18- You need to verify version-specific API behavior or exact method signatures.19- User asks you to search or query previously indexed documentation.2021## Workflow22231. Run `docmancer list` to see indexed docs.242. Run `docmancer query "question"` when relevant docs are present.253. If local docs are missing and the user approves the path, run `docmancer ingest <path>`.264. If URL docs are missing and the user approves the source, run `docmancer add <url>`.275. Use the returned sections as source-grounded context for the answer or code change.2829## Ingest Local Documentation3031```bash32docmancer ingest ./docs33```3435Use `ingest` for local files and directories.3637| Flag | Purpose |38|------|---------|39| `--include <glob>` | Include only matching relative paths |40| `--exclude <glob>` | Exclude matching relative paths |41| `--format <format>` | Restrict to formats such as `md`, `txt`, `pdf`, `docx`, `rtf`, or `html` |42| `--recursive / --no-recursive` | Recurse through directories |43| `--skip-known` | Skip files whose content hash is already indexed |44| `--ocr mistral` | Extract markdown from PDFs and images with Mistral OCR before indexing (requires `MISTRAL_API_KEY`) |45| `--recreate` | Drop and rebuild the index; when vector sync is enabled, drops the vector collection first so embedder or dimension changes rebuild cleanly |4647An OKF bundle (a directory of markdown files with YAML frontmatter, produced by `docmancer memory export --format okf` or another OKF tool) can be ingested directly: reserved `index.md` / `log.md` files are skipped and `type` / `tags` / `timestamp` frontmatter is lifted into the index.4849## Add URL Documentation5051```bash52docmancer add https://docs.example.com53```5455Use `add` for documentation URLs and GitHub repositories.5657| Flag | Purpose |58|------|---------|59| `--provider <auto\|gitbook\|mintlify\|web\|github>` | Force a specific provider |60| `--strategy <strategy>` | Force discovery strategy (`llms-full.txt`, `sitemap.xml`, `nav-crawl`) |61| `--max-pages <n>` | Cap pages fetched |62| `--browser` | Playwright fallback for JS-heavy sites |63| `--recreate` | Drop and rebuild the index |6465## Query Documentation6667```bash68docmancer query "<question>"69```7071Primary command. Returns a compact markdown context pack with source attribution and token savings.7273| Flag | Purpose |74|------|---------|75| `--budget <n>` | Max estimated output tokens |76| `--limit <n>` | Max sections to return |77| `--expand` | Include adjacent sections around matches |78| `--expand page` | Include the full matching page within the budget |79| `--format <markdown\|json>` | Output format |80| `--allow-degraded` | In dense, sparse, or hybrid modes, fall back to remaining signals (for example lexical) when vector retrieval fails instead of exiting with an error |8182## Manage Sources8384| Command | Purpose |85|---------|---------|86| `docmancer list` | Show indexed documentation sources |87| `docmancer list --all` | Show every stored page or file |88| `docmancer inspect` | Show index stats, format counts, and extract locations |89| `docmancer update [source]` | Re-fetch and re-index all sources, or one specific source |90| `docmancer remove <source>` | Remove a source or docset root |91| `docmancer remove --all` | Clear the entire index |92| `docmancer clear` | Wipe docmancer home, model caches used by docmancer, and managed Qdrant data (destructive; use `--dry-run`, `--keep-config`, or `--keep-models` as needed) |93| `docmancer doctor` | Check config, loader availability, index health, and installed skills |94| `docmancer fetch <url> --output <dir>` | Download docs to markdown without indexing (add `--format okf` for an OKF bundle) |9596## Common Mistakes9798- Do not use `docmancer add` for new local files. Use `docmancer ingest <path>`.99- Do not use `docmancer ingest` for URLs. Use `docmancer add <url>`.100- Do not run `docmancer query` before checking indexed sources with `docmancer list`.101- Do not assume docs are indexed. Always verify with `docmancer list` before querying.102103---104> Source: [docmancer/docmancer](https://github.com/docmancer/docmancer) — distributed by [TomeVault](https://tomevault.io).105<!-- tomevault:4.0:skill_md:2026-06-19 -->
tomevault-io