ministr

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.

Install

curl -fsSL https://ministr.ai/install.sh | bash

Or build it yourself:

cargo install --git https://github.com/OlsonSoftware/ministr --locked ministr-cli

Building 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.

Use

cd your-project
ministr init

ministr 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.

Learn more

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

License

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.