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 install

Interactive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace. Pass --ide <ide> for non-interactive install (e.g. npx octocode-cli install --ide cursor).

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"]
    }
  }
}

</details> <details> <summary><strong>Research Skill (Direct Install)</strong></summary>

npx add-skill https://github.com/bgauryy/octocode-mcp/tree/main/skills/octocode-research

</details>

---

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

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"> _{Built with care for the AI Engineering Community} </div>