Octocode
Local code search and symbol graph for AI assistants, built in Rust
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.29.2
- Listing updated
- 2 days ago
About Octocode
Octocode is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Two layers sit behind the MCP tools. The always-on layer is a tree-sitter graph of files, symbols and their contains, imports, calls, extends and implements links, built from the current source with no index to go stale. The optional layer adds embedding-based search over an index you create with octocode index, and language-server tools when you start it with --with-lsp.
Structural search matches code by syntax shape, such as every .unwrap() call, which grep cannot express. Search can take several queries at once, filter by language, search documentation, or search Git history by meaning with a commits mode.
Defaults are local: FastEmbed models on CPU, no API key, and .gitignore respected; cloud embedding providers are opt-in. The project publishes a benchmark of 127 annotated queries against its own source, including a finding that a generic reranker hurt results. The website also links to Octomind cloud plans, which are separate from the CLI.
Install
Run in a terminal
claude mcp add octocode -- npx -y @muvon/octocodeAdd to claude_desktop_config.json
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"octocode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octocode"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": [
"-y",
"@muvon/octocode"
]
}
}
}Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- graphrag
- Graph lookup, relationship traversal and path finding.
- structural_search
- AST pattern matching across the tree.
- lsp_goto_definition
- Language-server go-to-definition.
- lsp_find_references
- Language-server find references.
- lsp_hover
- Language-server hover information.
What it does
- Live symbol graph
- Tree-sitter extracts files, symbols and relationships directly from current source.
- Structural search
- Finds code by AST pattern regardless of formatting or names.
- Semantic and hybrid search
- Combines vector and keyword search with configurable reranking.
- LSP navigation
- With --with-lsp, adds go-to-definition, references and hover from a language server.
- Commit search
- Searches Git history by meaning to find the change that introduced a pattern.
- Local by default
- Uses local embedding and reranking models with no API key.
Good for
- Onboard to an unfamiliar codebase by tracing a flow across files
- List every caller and importer before refactoring a function
- Find all instances of a syntax pattern across a repo
- Give Claude Code or Cursor repository-wide context
- Locate which commit introduced a behaviour
Pricing
Open source
The CLI is free; Octomind cloud plans on the vendor site are separate
Prices change. Check octocode.muvon.io before you buy.
Octocode FAQ
Does it need an API key?
No. Default embedding and reranking run locally with FastEmbed; remote providers are optional.
Which clients does it support?
Claude Code, Codex CLI, Claude Desktop, Cursor and Windsurf are documented.
Do I have to index first?
Only for semantic search. Structural search, signatures and the dependency graph read current source without an index.
How do I install it?
Use the install script, brew install muvon/tap/octocode, cargo install octocode, or the npm package @muvon/octocode.
Is Octocode free?
Yes. Octocode is open source, so you can use and self-host it for free.
How do I add Octocode to Claude Code?
Run this command in your terminal: claude mcp add octocode -- npx -y @muvon/octocode
What are the best alternatives to Octocode?
The closest alternatives to Octocode are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Octocode

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools