Octocode: Research Driven Development for AI
<div align="center"> <img src="https://github.com/bgauryy/octocode-mcp/raw/main/packages/octocode-mcp/assets/logo_white.png" width="400px" alt="Octocode Logo"> <h3>Stop Guessing. Start Knowing.</h3> <p><strong>Empower your AI assistant with the skills of a Senior Staff Engineer.</strong></p> <p> <a href="https://octocode.ai"><strong>octocode.ai</strong></a> </p> </div>Installation
Prerequisites: GitHub authentication required. See Authentication Setup.
Recommended: Octocode CLI
npx octocode-cli
Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace.
Alternative Methods
<details> <summary><strong>One-Click Install (Cursor)</strong></summary><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">
</details> <details> <summary><strong>Manual MCP Configuration</strong></summary>Add to your MCP configuration file:
{
"mcpServers": {
"octocode": {
"command": "npx",
"args": ["octocode-mcp@latest"]
}
}
}
npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research
MCP Server
The Octocode MCP Server connects your AI assistant to code:
- GitHub & GitLab: Search repositories, find usage patterns, read implementations, explore PRs
- Local Tools: Search code, browse directories, find files in your local codebase
- LSP Intelligence: Go to Definition, Find References, Call Hierarchy -- compiler-level understanding
https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071
Skills
Agent Skills are a lightweight, open format for extending AI agent capabilities. Skills index: skills/README.md
| Skill | What it does |
|---|---|
| Researcher | Code search & exploration — local LSP + external (GitHub, npm/PyPI) |
| Research | Multi-phase research with sessions, checkpoints, state persistence |
| Engineer | Understand, write, analyze, audit code — AST + LSP + dependency graph |
| Plan | Evidence-based planning: Understand > Research > Plan > Implement |
| RFC Generator | Formal technical decisions with alternatives, trade-offs, and recommendations |
| PR Reviewer | PR & local code review across 7 domains with LSP flow tracing |
| Roast | Brutal code critique with file:line citations and severity levels |
| Prompt Optimizer | Turn weak prompts into enforceable agent protocols |
| Doc Writer | 6-phase pipeline producing 16+ validated docs |
https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec
Documentation
For the full documentation index, start here: docs/README.md
Recommended quick links:
- Authentication Setup
- Configuration Reference
- Local Tools + LSP Reference
- CLI Skills Guide
- Skills Index
- Troubleshooting
The Manifest
"Code is Truth, but Context is the Map." -- Read the Manifest for Research Driven Development to understand the philosophy behind Octocode.
Contributing
See the Development Guide for monorepo setup, testing, and contribution guidelines.
<div align="center"> <sub>Built with care for the AI Engineering Community</sub> </div>