sourcegraph-claudecode-plugin

Sourcegraph plugin for Claude Code that adds:

Sourcegraph MCP server connectivity (code search, navigation, Deep Search)
searching-sourcegraph skill for disciplined search workflows (with supporting workflows and query patterns)

Prerequisites

Claude Code version 1.0.33 or later (claude --version)
A Sourcegraph instance with MCP enabled
A Sourcegraph access token with mcp scope

Set the required environment variables in your shell profile (.zshrc, .bashrc, etc.):

export SOURCEGRAPH_ENDPOINT="https://sourcegraph.example.com"
export SOURCEGRAPH_ACCESS_TOKEN="<your-token>"

Install (permanent)

Add this repository as a marketplace, then install the plugin:

# From a local clone
claude plugin marketplace add ./sourcegraph-claudecode-plugin

# Or directly from GitHub
claude plugin marketplace add sourcegraph-community/sourcegraph-claudecode-plugin

Then install:

claude plugin install sourcegraph@sourcegraph-claudecode-plugin

Restart Claude Code after installing.

Install (per-session, for development)

Load the plugin for a single session without installing permanently:

claude --plugin-dir ./sourcegraph-claudecode-plugin

Run /reload-plugins after making changes during a session.

Alternative: add MCP server only

If you only want the Sourcegraph MCP tools without the skills, add the server directly:

claude mcp add --transport http sourcegraph \
  "${SOURCEGRAPH_ENDPOINT}/.api/mcp" \
  --header "Authorization: token ${SOURCEGRAPH_ACCESS_TOKEN}"

Verify

After installing, confirm everything loaded:

/help should list sourcegraph:searching-sourcegraph
/mcp should show the sourcegraph MCP server as connected

Structure

.
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .mcp.json
├── skills/
│   └── searching-sourcegraph/
│       ├── SKILL.md
│       ├── query-patterns.md
│       ├── examples/
│       │   └── common-searches.md
│       └── workflows/
│           ├── implementing-feature.md
│           ├── understanding-code.md
│           ├── debugging-issue.md
│           ├── fixing-bug.md
│           └── code-review.md
└── README.md

Skill

The plugin installs one skill: searching-sourcegraph. Claude auto-invokes it when you need to search or navigate code via Sourcegraph. It includes workflows for implementing features, understanding code, debugging issues, fixing bugs, and code review.

MCP Details

Endpoint: ${SOURCEGRAPH_ENDPOINT}/.api/mcp
Transport: HTTP ("type": "http")
Auth header: Authorization: token <token>

Sourcegraph

Installation

How to install

README