Docmancer

<div align="center"> <h1><img src="https://raw.githubusercontent.com/docmancer/docmancer/main/readme-assets/wizard-logo.png" width="56" height="56" alt="docmancer logo" style="vertical-align: middle; margin-right: 10px;" /> docmancer</h1>

Stop your AI from hallucinating APIs. Ground your agents in version-specific docs, locally, for free.

<br> <img src="readme-assets/demo.gif" alt="docmancer demo" width="720" /> <br> <table><tr><td>

✔ Up-to-date, version-specific documentation straight from the source<br> ✔ Only the chunks your agent needs, not the whole doc site<br> ✔ 100% local. Embeddings, storage, retrieval all on your machine.<br> ✔ Completely free. No rate limits, no quotas, no API keys.<br> ✔ Works offline once ingested. Private and internal docs supported.<br> ✔ No MCP server. Installs as a skill, runs as a CLI.

</td></tr></table> <pre align="center"><code>pipx install docmancer --python python3.13</code></pre>

Quickstart · The Problem · Agents · Why Local? · Commands · Install · Wiki

</div>

---

Quickstart

# 1. Install pipx
brew install pipx
pipx ensurepath

# 2. Open a new shell, then install docmancer
pipx install docmancer --python python3.13

# 3. Ingest a docs source
docmancer ingest https://docs.example.com

# 4. Install the skill into your agents
docmancer install claude-code
docmancer install cursor
docmancer install codex

# 5. Query from the CLI
docmancer query "How do I authenticate?"

No server to start. Config and the default vector store are created under ~/.docmancer/ on first use.

---

The Problem

AI agents hallucinate APIs. They invent CLI flags, fabricate method signatures, and confidently cite documentation from versions that no longer exist. The root cause is simple: their training data has a cutoff, and they fill gaps by guessing.

The obvious fix, dumping entire doc sites into context, makes it worse. You burn thousands of tokens on irrelevant text and bury the one paragraph that actually matters.

Cloud-based documentation tools add rate limits, usage tiers, and route your queries through third-party servers. Docmancer takes a different approach: you ingest docs once, they are chunked and indexed locally, and the agent retrieves only the matching sections when it needs them.

---

Works With Every Agent

Docmancer installs a skill file into each agent that teaches it to call the CLI directly. One local index, one ingest step, every agent covered.

| Agent | Install command | | -------------- | ---------------------------------- | | Claude Code | docmancer install claude-code | | Codex | docmancer install codex | | Cursor | docmancer install cursor | | Gemini CLI | docmancer install gemini | | OpenCode | docmancer install opencode | | Claude Desktop | docmancer install claude-desktop |

Skills are plain markdown files. No background daemon, no MCP server, no ports. Use --project with claude-code or gemini to install into the current working directory instead of globally.

---

Why Local?

| | DocMancer | | ------------------ | -------------------------------------- | | Cost | Free, always. No tiers, no quotas. | | Rate limits | None. Query as much as you want. | | Private docs | Supported free. No paid plan required. | | Data privacy | Nothing leaves your machine. | | Infrastructure | No server. CLI + local storage. | | Offline use | Yes, after ingestion. | | Embedding | Local FastEmbed. No API key needed. |

---

Commands

| Command | What it does | | -------------------------------- | ---------------------------------------------------- | | docmancer ingest <url-or-path> | Fetch, chunk, embed, and index docs locally | | docmancer query <text> | Retrieve relevant chunks from the local index | | docmancer install <agent> | Install skill file for a supported agent | | docmancer list | List ingested sources with timestamps | | docmancer fetch <url> | Download GitBook docs as markdown (no embedding) | | docmancer remove <source> | Remove an ingested source from the index | | docmancer inspect | Show collection stats and config | | docmancer doctor | Health check: PATH, config, Qdrant, installed skills | | docmancer init | Create a project-local docmancer.yaml |

Use --full with docmancer query to return the entire chunk body (default truncates at 1500 characters). Use --limit N to change how many chunks are returned.

---

Install

brew install pipx
pipx ensurepath
# open a new shell, then:
pipx install docmancer --python python3.13

Supports Python 3.11-3.13. On Apple Silicon, prefer the native Homebrew Python:

pipx install docmancer --python /opt/homebrew/bin/python3.13

Upgrade with pipx upgrade docmancer.

---

Documentation

For configuration, troubleshooting, architecture details, and more, see the GitHub Wiki.

---

Contributing

See CONTRIBUTING.md.

License

MIT License. See LICENSE.

---

<div align="center">

Your agents are guessing. Fix that in two commands.

</div>