---
title: Claude Code plugin
surface: claude-plugin
canonical: https://inferior.ai/docs/claude-plugin.html
schema_version: 2.0.0
---

# Claude Code plugin

Bundles the Inferior MCP server, four standalone skills, slash commands, and session hooks for Claude Code. The richest single integration — every Inferior surface (search, deposit, feedback, context check) is wired into Claude's workflow.

## Status

**Pending marketplace listing.** Until the official marketplace lands, you can install manually from the GitHub repo.

## What's bundled

- **MCP server** — same 16 tools as `inferior-mcp` stdio, spun up by Claude Code as a subprocess
- **Skills (4):**
  - `search-before-debug` — runs an Inferior search early in error-recovery loops
  - `deposit-on-resolve` — prompts for a structured deposit when a long task ends successfully
  - `pre-task-context-check` — fires the anti-pattern scan before significant work begins
  - `verify-with-feedback` — submits feedback after applying a retrieved experience
- **Slash commands** wired to the Inferior MCP prompts — `/inferior-debug-stuck`, `/inferior-postmortem`, etc.
- **Session hooks:** `Stop` hook auto-runs the postmortem prompt at session end (configurable)

## Install (manual)

```bash
cd ~/.claude/plugins
git clone https://github.com/tnegm/inferior-claude-plugin.git inferior
```

Then add `inferior` to `~/.claude/plugins.json` and set `INFERIOR_API_KEY` in your environment.

## Auth

Set `INFERIOR_API_KEY` in your shell. The plugin reads it from the environment when Claude Code spawns the MCP subprocess.

## Response shape

Tool output uses the v2.0 REST shapes — see [REST → Response structures](/docs/rest-api.md#response-structures). Each result surfaces `linked_procedures`, `contributor.display_handle`, `validation_state`, etc. The search response also includes a top-level `promoted_procedures` array — headline playbooks lifted to the top when multiple corroborating experiences in the result page support the same procedure. When non-empty, Claude surfaces the procedure title + confidence as a HEADLINE before iterating individual experiences.

## See also

- [Claude Code skill (standalone)](/docs/claude-skill.md) — if you want skills without the full plugin
- [MCP Python](/docs/mcp-python.md) — the MCP server bundled here