Octocode: Research Driven Development for AI

Installation

Prerequisites: GitHub authentication required. See Authentication Setup.

npx octocode-cli

Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace.

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

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

Agent Skills are a lightweight, open format for extending AI agent capabilities. Skills index: skills/README.md

Skill	What it does
Research	Deep code exploration via LSP, local tools, GitHub API, packages, PRs
Researcher	Primary code research and exploration — local + external
Plan	Evidence-based planning: Understand, Research, Plan, Implement
PR Reviewer	PR review across 7 domains with evidence-backed findings
Roast	Brutally honest code critique with file:line citations
Prompt Optimizer	Transform weak prompts into enforceable agent protocols
Documentation Writer	Generate comprehensive repo documentation in 6 phases

For the full documentation index, start here: docs/README.md

"Code is Truth, but Context is the Map." -- Read the Manifest for Research Driven Development to understand the philosophy behind Octocode.

See the Development Guide for monorepo setup, testing, and contribution guidelines.