Octocode
@bgauryy
Advanced AI code assistant that intelligently searches and discovers connections across GitHub repositories and NPM packages. Features zero-config authentication, smart fallbacks, and LLM-optimized content delivery. Ask natural language questions to understand code architectures,
Overview
What is Octocode?
Octocode is an AI-powered code assistant that provides advanced search and discovery across GitHub and NPM ecosystems. It uses heuristic algorithms with smart fallbacks to understand connections between repositories and NPM packages across public, private, and organization repositories. It is designed for developers and technical researchers who want to explore code intelligently.
How to use Octocode?
Install Node.js 18.12+ and GitHub CLI, then authenticate with gh auth login (and optionally npm login). Add "octocode-mcp" to your MCP configuration with npx octocode-mcp. Octocode automatically works with your repositories — just ask natural language questions. It is also available as a Desktop Extension (DXT) for Claude Desktop.
Key features of Octocode
- AI-powered search with heuristic pattern recognition and automatic fallbacks
- Connection mapping between NPM packages and GitHub repositories
- Zero-config security using GitHub CLI OAuth — no tokens needed
- Universal access to public, private, and organization repositories
- Advanced content minification reduces LLM token usage by 80‑90%
- 10 specialized tools for discovery, analysis, activity, and content
Use cases of Octocode
- Understand how popular libraries implement specific patterns (e.g., React concurrent rendering)
- Find authentication patterns in frameworks like Next.js
- Compare implementations across projects (e.g., React vs Vue.js rendering)
- Analyze code from specific commits, PRs, or historical versions
- Build tutorials or examples by discovering real-world code snippets
FAQ from Octocode
How does Octocode authenticate?
It uses GitHub CLI (gh) OAuth flow — no personal access tokens needed. Works with SSO, 2FA, and organization access.
What are the runtime requirements?
Node.js 18.12+ and GitHub CLI. NPM login is optional for package research.
Where does my data live?
Octocode runs 100% locally on your machine — no data collection or telemetry is transmitted.
How does Octocode differ from other GitHub MCPs?
While others focus on project management or basic operations, Octocode provides AI-powered code discovery and deep technical research across the entire GitHub and NPM ecosystem.
What transport and auth does Octocode use?
It uses the MCP protocol via command-line transport (npx). Authentication is handled entirely through the GitHub CLI, with no separate tokens or configuration needed.
