Sourcegraph

sourcegraph-claudecode-plugin

Sourcegraph plugin for Claude Code that adds:

• Sourcegraph MCP server connectivity (code search, navigation, Deep Search, Code Finder, evaluator)
• 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/all" \
  --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