Octocode
Semantic Search • Knowledge Graphs • MCP Server
Transform your codebase into a queryable semantic knowledge graph. Ask questions in natural language, understand cross-file dependencies, and give your AI assistant deep codebase awareness — all via MCP.
brew install muvon/tap/octocodeKey Features
Semantic Code Search
Search your codebase by meaning, not keywords. Ask "how does authentication work?" and get relevant code across all files. 65% of developers report AI tools miss context during refactoring — Octocode fixes that by understanding what code does, not just what it says.
Knowledge Graph
Builds cross-file dependency maps using tree-sitter AST parsing. Understands imports, function calls, type references, and module boundaries. When you ask about a function, you get the full picture — callers, callees, and related types across 12+ languages.
MCP Server for AI Assistants
Exposes your codebase as tools to Claude, Cursor, Windsurf and any MCP client. Your AI assistant gets semantic search, signature viewing, and GraphRAG queries. Nearly a third of developers want richer codebase awareness from AI — this delivers it.
Why Octocode?
grep and text search fail for conceptual queries
Semantic search understands meaning: "HTTP middleware" finds auth handlers, rate limiters, and CORS config even if they never use that phrase.
AI assistants lack codebase awareness
The MCP server gives Claude, Cursor, and Windsurf deep understanding of your code structure, imports, and dependencies — not just file contents.
Onboarding takes days of reading unfamiliar code
Ask questions in natural language and get answers that span multiple files. Sub-2-second indexing means you can start immediately.
MCP Tools
Available via Model Context Protocol for AI assistants
semantic_search Natural language code search across your entire codebaseview_signatures Extract function/type signatures without reading full implementationsgraphrag Query code relationships, dependencies, and call graphsWhen to Use Octocode
Developer Onboarding
New to a codebase? Ask "how does the payment flow work?" and get a full trace across files in seconds. No more hours of grepping and reading unfamiliar code.
AI Pair Programming
Give Claude or Cursor complete codebase context. When AI tools autonomously select context, frustration with missed relevance drops from 54% to just 16%.
Refactoring & Code Archaeology
Understand all dependencies before making changes. Find legacy patterns without knowing exact names. The knowledge graph shows you the blast radius of every change.
Code Review
"Show me all error handling in the API layer" — get instant structural answers. Review code by intent, not by file path.
Works With
Supported Languages
Install
Homebrew
brew install muvon/tap/octocode One command. Auto-updates. No build step.
Build from Source
git clone https://github.com/muvon/octocode && cd octocode && cargo build --releaseTech Stack
Built in the Open
Octocode is open source under the Apache 2.0 license. Contributions, issues, and stars are welcome.