docmancer

name	docmancer
description	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.

docmancer

Docmancer extracts memory atoms from the agent files already on this machine into one local, offline index, and it indexes documentation you choose on the same engine. This skill is the docs side: it ingests local files, fetches public docs, indexes everything locally with SQLite FTS5, and returns compact context packs with source attribution, so coding agents spend tokens on code, not on rereading raw docs. To recall past decisions or project context instead, use docmancer query. 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

1. Run docmancer docs list to see indexed docs.
2. Run docmancer docs query "question" when relevant docs are present.
3. If local docs are missing and the user approves the path, run docmancer docs add <path>.
4. If URL docs are missing and the user approves the source, run docmancer docs add <url>.
5. Use the returned sections as source-grounded context for the answer or code change.

Ingest Local Documentation

docmancer docs add ./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
--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 docs 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 docs 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 docs list	Show indexed documentation sources
docmancer docs list --all	Show every stored page or file
docmancer docs list	Show index stats, format counts, and extract locations
docmancer docs sync [source]	Re-fetch and re-index all sources, or one specific source
docmancer docs remove <source>	Remove a source or docset root
docmancer docs 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 status --check	Check config, loader availability, index health, and installed skills
docmancer docs add <url> --output <dir>	Download docs to markdown without indexing (add --format okf for an OKF bundle)

Common Mistakes

• Do not use docmancer docs add for new local files. Use docmancer docs add <path>.
• Do not use docmancer docs add for URLs. Use docmancer docs add <url>.
• Do not run docmancer docs query before checking indexed sources with docmancer docs list.
• Do not assume docs are indexed. Always verify with docmancer docs list before querying.