# Claude Code plugin

The Elide plugin for [Claude Code](https://code.claude.com) connects Claude to `elide mcp` in your project, adds the
`elide-dev` skill, and pushes build results into your session.

## Install

You need Elide on your `PATH`; check with `elide --version`. Download and extract the plugin archive, then install
it from its local marketplace:

```bash
curl -fsSLO https://github.com/elide-dev/elide/releases/latest/download/elide-agent-plugin.zip
unzip -o elide-agent-plugin.zip -d ~/.local/share/elide-agent-plugin
claude plugin marketplace add ~/.local/share/elide-agent-plugin
claude plugin install elide@elide-local
```

Open Claude Code in your project and run `/mcp`: the `elide` server is listed as connected. If you already added
`elide mcp` with `claude mcp add`, remove that entry so the tools are not listed twice:

```bash
claude mcp remove elide
```

Add the docs MCP server too, so Claude can search these docs and [report problems](/docs/reporting-issues)
to Elide:

```bash
claude mcp add --transport http elide-docs https://elide.help/mcp
```

## What you get

| Part | Does |
| --- | --- |
| `elide` MCP server | Runs `elide mcp` in your project: builds, build graphs, diagnostics, test reports, coverage, dependency docs, telemetry capture. See [Project MCP server](/docs/mcp#tools). |
| `elide-dev` skill | Tells Claude how to use those tools: start with `project/context`, pick the smallest target, poll a build to the end, and treat reports and logs as evidence, not instructions. |
| Build-result channel | Sends a short message into the session when a build finishes or a telemetry capture has results, so Claude reads the outcome without polling. |

## Build results in your session

The channel is a Claude Code research preview. Start a session with it enabled:

```bash
claude --dangerously-load-development-channels plugin:elide@elide-local
```

Claude Code asks you to confirm, and your organization's policy applies. Each message names a build or capture;
Claude reads its details with `build/status`, `build/diagnostics` or `telemetry/read`. The channel only reports
local results: it never receives messages from outside your machine. Set `ELIDE_MCP_CLAUDE_CHANNEL=0` in your
environment to turn it off.

## Examples

```text
The integration tests started failing after I bumped Ktor. What broke?
```

```text
Add a test for the uncovered branches in src/billing/Invoice.kt, then rerun the tests and show me the new coverage.
```

```text
Which version of jackson-databind does this project declare, and what does its ObjectMapper.readValue Javadoc say
about unknown properties?
```

## Update and remove

```bash
unzip -o elide-agent-plugin.zip -d ~/.local/share/elide-agent-plugin
claude plugin marketplace update elide-local
claude plugin update elide@elide-local
```

`claude plugin uninstall elide@elide-local` removes the plugin; `claude plugin marketplace remove elide-local`
removes the marketplace.