Skip to content

chonkie-inc/mandex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

124 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

mandex

Documentation packages for AI agents.
The fastest way for agents to read the docs.

crates.io release registry license


mandex distributes library documentation like packages β€” versioned, cached locally, searchable offline in 40ms. No API keys, no rate limits, no network dependency.

Your AI agent gets the right docs for the right version, instantly.

Install

curl -fsSL https://mandex.dev/install.sh | sh

Or with Cargo:

cargo install mandex

Quick start

# Pull docs for a library
mx pull fastapi

# Search across installed docs
mx search fastapi "rate limiting"

# Show a specific entry
mx show fastapi "Rate Limiting"

# Auto-sync docs for all project dependencies
mx sync

Why mandex?

Cloud docs (MCP/API) mandex
Latency 300–500ms per query 40ms (local FTS5 + neural reranking)
Offline ❌ βœ…
Rate limits Per-provider quotas Unlimited
Versioning Latest only or manual Pinned to exact version
Setup API keys, tokens, config mx pull <package>

How it works

  1. Pull β€” download a compressed documentation index (SQLite + FTS5) from the registry
  2. Search β€” full-text search with BM25 ranking, automatically reranked by a local neural cross-encoder for semantic relevance
  3. Show β€” retrieve the full documentation entry for an exact match

Documentation is stored as local SQLite databases in ~/.mandex/cache/. A per-project .mandex/index.db merges all project dependencies into a single index for fastest search.

Agent integrations

mandex works with any AI coding assistant that can run shell commands:

# Set up integrations (Claude Code, Cursor, Windsurf, Codex)
mx init

# Or just use mx directly in your agent's tool calls
mx search nextjs "server actions"

mx init installs a skill for Claude Code, cursor rules for Cursor, and agent instructions for Codex β€” so your agent automatically searches mandex before writing code.

Commands

Command Description
mx search <package> "<query>" Search within a package
mx search "<query>" Search across all installed packages
mx show <package> "<entry>" Show full entry content
mx pull <package>[@version] Install docs for a package
mx sync Auto-detect and install docs for project dependencies
mx list Show installed packages
mx info <package> Show package details
mx remove <package> Remove a package
mx init Set up AI assistant integrations
mx build <dir> --name <n> --version <v> Build a .mandex package from markdown

Registry

55 packages across npm, pip, and cargo β€” browse the full registry.

View all packages

npm: ai-sdk, angular, astro, better-auth, claude-code, clerk, drizzle-orm, express, fumadocs, hono, langchain-js, mongodb, nest, nextjs, nuxt, openclaw, opencode, playwright, prisma, react, shadcn-ui, supabase, svelte, tailwindcss, tanstack-query, trpc, turborepo, vite, vitest, vue, zod, zustand

pip: celery, django, fastapi, flask, httpx, instructor, langchain, langgraph, llama-index, numpy, pandas, pydantic, pytest, requests, scipy, sqlalchemy, streamlit, transformers, uvicorn

cargo: axum, mandex, serde, tokio

Performance

  • 40ms average search latency (local FTS5 + reranking)
  • 70ms project-wide search across all dependencies (merged index)
  • 5ms tokenizer load (tokie .tkz binary format)
  • Pre-optimized ONNX reranker with mmap + multi-threaded inference

Building packages

Have documentation for a library? Build and publish it:

# Build from a directory of markdown files
mx build ./docs --name my-lib --version 1.0.0

# Output: my-lib@1.0.0.mandex (compressed SQLite + FTS5 index)

mandex accepts any directory of .md / .mdx files β€” Docusaurus, MkDocs, Mintlify, Starlight, or plain markdown all work.

Contributing

Contributions welcome. See the issues for open tasks.

License

MIT

About

πŸ“‘ The best way to have your Agents read the documentation! πŸ€–

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors