Octocode is an open-source (Apache-2.0) code intelligence tool by Muvon, written in Rust, delivered as a single binary that combines semantic search, a tree-sitter-based symbol/file knowledge graph, and a built-in MCP server usable from Claude Desktop, Cursor, Windsurf, Claude Code, Octomind, and other MCP clients. Its differentiator is understanding code structure (imports, calls, extends, implements) rather than treating code as flat text chunks, plus optional LSP support for go-to-definition and find-references. The project ships a reproducible retrieval benchmark showing that keyword-tuned hybrid retrieval notably improves Hit@5 and Recall@10. It is local-first and needs no API key by default, making it attractive to privacy-conscious teams that want structural understanding; however, it is a community project rather than an official product, and adopters should evaluate cloud data egress and index permissions before rolling it out.
Octocode is a Rust-built code intelligence tool that turns a project into a navigable knowledge graph so that Claude, Cursor, and other MCP clients can search, understand, and navigate the codebase structure. It builds a live graph of file and symbol nodes with deterministic contains, imports, calls, extends, and implements relationships directly from the current source via tree-sitter AST parsing; the MCP graphrag tool works from this graph without an index, embeddings, or an LLM. Optional indexed GraphRAG overlays semantic file matches, LLM descriptions, and broader file-level architectural relationships. Retrieval is hybrid: semantic similarity combined with BM25 full-text search and reranking. It is local-first by default, using fastembed so embeddings can run without an API key, while cloud embedding providers such as Voyage, OpenAI, Jina, and Google are also supported. It supports full tree-sitter AST parsing for 17 languages and is licensed under Apache-2.0.
curl -fsSL https://raw.githubusercontent.com/Muvon/octocode/master/install.sh | sh, or on macOS brew install muvon/tap/octocode, or cargo install octocode, or from source cargo install --git https://github.com/Muvon/octocode, or download a binary from GitHub Releases.export VOYAGE_API_KEY="your-voyage-api-key".cd /your/project then run octocode index.octocode search "authentication middleware"; filter by language with --language rust, or search commit history with --mode commits.{"mcpServers":{"octocode":{"command":"octocode","args":["mcp","--path","/your/project"]}}} to your MCP client config. With Claude Code you can run claude mcp add octocode -- octocode mcp --path /path/to/your/project.octocode mcp --path /your/project --with-lsp="rust-analyzer".octocode config --graphrag-enabled true then re-run octocode index.{
"mcpServers": {
"octocode": {
"command": "octocode",
"args": [
"mcp",
"--path",
"/your/project"
]
}
}
}