documango

• documango init [database-name]: create a new .usde database
• documango init -p /path/to/db.usde: create at explicit path

• documango add go <module>: ingest Go module from proxy.golang.org
• documango add go --stdlib [-s <start>] [-m <max>]: ingest Go stdlib packages
• documango add atproto: ingest AT Protocol lexicons, specs, and docs
• documango add hex <package>: ingest Elixir or Gleam package from Hex.pm
• documango add rust <crate>: ingest Rust crate from crates.io
• documango add github <owner/repo>: ingest Markdown documentation from GitHub repository

• documango search [-l N] [-t TYPE] [-f FORMAT] [-p PREFIX] <query>
  • Namespace Aware: Queries starting with rust/, go/, atproto/, hex/, or github/ automatically filter by that namespace.
  • Path Qualified: Searching for rust/serde/Serialize automatically treats rust/serde/ as a package prefix and Serialize as the symbol query.
  • FTS5 Optimized: Handles special characters (/, ::, -) automatically by quoting terms to prevent SQL syntax errors.
  • Formats: table (default), json, paths
  • Types: Func, Type, Package, Lexicon, etc.

• documango read [-r] [-w N] [-s SECTION] <path>: read full document
• documango read section -q <heading> [-r] [-w N] <path>: extract section by heading
  • Flags: --rg (force ripgrep), --gr (force grep)

• documango list [--type PREFIX] [--tree] [--count]: list all documentation paths
• documango info <path>: show document metadata

• documango cache status: show cache size and entry count
• documango cache list [PREFIX]: list cached items
• documango cache prune [--age N]: remove entries older than N days
• documango cache clear [--type TYPE]: clear cache

• documango config show: display current configuration
• documango config get <key>: get configuration value
• documango config set <key> <value>: set configuration value
• documango config edit: open in $EDITOR
• documango config path: print config file path
• -q, --quiet: suppress non-error output
• --no-color: disable colored output

• -d, --database PATH: database path (default: XDG data directory)
• -v, --verbose: enable verbose output
• -q, --quiet: suppress non-error output
• --no-color: disable colored output

• documango mcp serve [--stdio] [--http ADDR]: start the MCP server
  • --stdio: use standard input/output (for Claude Desktop, etc.)
  • --http: use streamable HTTP transport on the given address
• -d, --database PATH: specify the database to serve

Documango uses a single Go ingestion pipeline for both:

• Go modules via proxy.golang.org
• Go standard library via pkg.go.dev (directory list) + go.googlesource.com (archive fetch)

Caching: Module zips and stdlib tarballs are cached indefinitely in ~/.cache/documango/ to avoid re-fetching.

The standard library is stored in the Go namespace with paths like:

• go/net/http
• go/crypto/tls

Go ingestion extracts:

• Markdown docs via gomarkdoc
• FTS5 search entries (name, type, body)
• Agent context (signatures + synopsis)

Ingests three documentation sources from Bluesky's GitHub repositories:

• Lexicons: JSON schemas converted to Markdown (atproto/lexicon/*)
• Protocol Specs: Technical specifications from atproto-website (atproto/spec/*)
• Developer Docs: Tutorials and guides from bsky-docs (atproto/docs/*)

Ingests documentation for BEAM (Elixir, Erlang, and Gleam) packages directly from Hex.pm.

• Gleam: Parses package-interface.json to extract full type signatures, function signatures with labeled parameters, type definitions with constructors, and documentation strings. Generates comprehensive Markdown with Gleam syntax code blocks.
• Elixir/Erlang: Extracts documentation and metadata from ExDoc's search_data-*.js.

Caching: Documentation tarballs are cached in ~/.cache/documango/hex/packages/.

The packages are stored in the hex namespace with paths like:

• hex/phoenix/Phoenix.Controller
• hex/gleam_stdlib/gleam/list

Ingests Markdown documentation from GitHub repositories. Automatically discovers and processes all Markdown files including README, docs/ folders, and nested documentation.

• API mode: For smaller repositories, fetches content via the GitHub Git Trees API and raw file URLs
• Clone mode: Falls back to git clone for large repositories when the tree API returns truncated results
• Front matter: Extracts title from YAML front matter (e.g., title: My Doc) or falls back to the first H1 heading
• Rate limiting: Respects GitHub API rate limits with automatic retry and wait behavior

Caching: Cloned repositories are cached in ~/.cache/documango/github/repos/ for reuse across ingestions.

Documents are stored in the github namespace with paths like:

• github/folke/snacks.nvim/README.md
• github/folke/snacks.nvim/docs/dashboard.md
• github/changesets/changesets/docs/intro.md

Documango stores all documentation in a single SQLite database (.usde). The design is intentionally simple and optimized for fast local search and cheap retrieval:

• documents holds compressed Markdown blobs, keyed by a virtual path (e.g., go/net/http)
• search_index is an FTS5 virtual table (trigram tokenizer) that supports fast substring search and ranking
• agent_context stores low‑token summaries and signatures for fast AI retrieval without decompressing full docs

erDiagram
  documents ||--o{ search_index : "doc_id"
  documents ||--o{ agent_context : "doc_id"

  documents {
    INTEGER id PK
    TEXT path
    TEXT format
    BLOB body
    BLOB raw_html
    TEXT hash
  }

  search_index {
    TEXT name
    TEXT type
    TEXT body
    INTEGER doc_id FK
  }

  agent_context {
    INTEGER doc_id FK
    TEXT symbol
    TEXT signature
    TEXT summary
  }

Search scoring details:

• Exact match bonus: +100 if the symbol name exactly matches the query
• BM25 score: Subtracted from the bonus (BM25 returns lower values for better matches)
• Result: Higher scores = more relevant