Skip to main content
Glama

Octocode: Research Driven Development for AI


Installation

Prerequisites: GitHub authentication required. See Authentication Setup.

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

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

Related MCP server: GitHub Enterprise MCP Server

MCP Server

The Octocode MCP Server connects your AI assistant to code:

  • GitHub, GitLab & Bitbucket: Search repositories, find usage patterns, read implementations, explore PRs/MRs

  • Local Tools: Search code (ripgrep), browse directories, find files in your local codebase

  • LSP Intelligence: Go to Definition, Find References, Call Hierarchy — compiler-level understanding

  • Package Discovery: Resolve npm/PyPI packages to their source repos

https://github.com/user-attachments/assets/de8d14c0-2ead-46ed-895e-09144c9b5071


Packages

This is a yarn-workspaces monorepo. Each package has its own README.md; all setup/reference docs live in docs/, and all AI agent guidance lives in the root AGENTS.md.

Package

Purpose

octocode-mcp

MCP server — 14 tools across GitHub/GitLab/Bitbucket, local FS, LSP

octocode-cli

CLI — installer, tool runner, skills marketplace

octocode-vscode

VS Code extension — GitHub OAuth + multi-editor MCP install

octocode-shared

Shared utilities — credentials, session, platform

octocode-security-utils

Standalone security utilities


Skills

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

Research & Code Analysis

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

Brainstorming

Idea validation grounded in evidence — GitHub, npm/PyPI, web in parallel

News

What's new in AI, dev tools, web platform, security, notable repos

Planning & Writing

Skill

What it does

Plan

Evidence-based planning: Understand > Research > Plan > Implement

RFC Generator

Formal technical decisions with alternatives, trade-offs, and recommendations

Doc Writer

6-phase pipeline producing 16+ validated docs

Prompt Optimizer

Turn weak prompts into enforceable agent protocols

Agentic Flow

Thinking framework for designing/reviewing MCP & multi-agent workflows

Review & Critique

Skill

What it does

PR Reviewer

PR & local code review across 7 domains with LSP flow tracing

Roast

Brutal code critique with file:line citations and severity levels

Build & Output

Skill

What it does

Slides

Polished multi-file HTML presentations via 6-phase design flow

Design

Dynamic DESIGN.md generator covering visual language, components, a11y

Chrome DevTools

CDP-level browser debugging: network, console, perf, DOM, screenshots

Tooling & Setup

Skill

What it does

Install

Interactive step-by-step Octocode installer for macOS and Windows

CLI

Run Octocode MCP tools from the terminal without wiring MCP

Search Skill

Find, evaluate, install, refactor Agent Skills (SKILL.md format)

Stats

Local HTML dashboard from Octocode MCP usage stats

https://github.com/user-attachments/assets/5b630763-2dee-4c2d-b5c1-6335396723ec


Documentation

Full index: docs/README.md. All monorepo documentation lives in docs/ — no per-package docs/.

Docs map

  • docs/configuration/ — install, auth providers, MCP clients, env/config, troubleshooting

  • docs/dev/ — tool/API references, workflows, architecture, contributing, skills

  • docs/specs/ — design specs and RFCs

Setup

Tool References

CLI & Skills

Shared Internals

Operations

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.


Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
8dResponse time
2wRelease cycle
12Releases (12mo)
Issues opened vs closed

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bgauryy/octocode'

If you have feedback or need assistance with the MCP directory API, please join our Discord server