Real codebase understanding for AI coding agents.
ministr is a local, MIT-licensed code intelligence MCP server. It gives AI coding agents AST-level understanding of your codebase — semantic search across code and docs, symbol navigation, real reference graphs, and cross-language bridge detection across 40+ languages. It runs locally, embeds locally, and works with any MCP client — Claude Code, Cursor, VS Code / Copilot.
curl -fsSL https://ministr.ai/install.sh | bashOr build it yourself:
cargo install --git https://github.com/OlsonSoftware/ministr --locked ministr-cliBuilding requires Rust (rustup picks up the pinned
toolchain automatically) and a C toolchain. From a clone:
cargo install --path ministr-cli --locked. On Windows, add
--features directml for DirectML GPU acceleration.
Prebuilt binaries cover macOS on Apple Silicon, Linux x86_64 and aarch64, and Windows x86_64. The Windows build is published but not exercised by CI, and Intel Macs need a source build — details in installation.
cd your-project
ministr initministr init writes .ministr.toml — corpus paths auto-detected from your
project manifests — and the MCP configs for Claude Code, Cursor, and
VS Code / Copilot. Indexing happens automatically the first time an agent
connects.
Documentation — installation, client setup, configuration, tool reference — lives in docs/. Configuration examples in examples/; agent-facing usage notes in AGENTS.md.
Stability states which surfaces the 1.x line
promises not to break. ministr ui, the terminal console, is a preview and is
deliberately excluded from that promise.
CHANGELOG · CONTRIBUTING · SECURITY · STEWARDSHIP
The local stack is MIT and builds the complete ministr binary with
no cloud or proprietary dependencies. ministr is open-core — see
STEWARDSHIP.md for the split and our commitments.