Skip to main content
plugin CX Codex

speckit-companion · alfredoperez, claude-mod — Claude Code plugin: what it does, how to install

speckit-companion displays live Spec Kit run progress directly in Claude Code, adding a status band above the prompt and a side pane for steps, documents, and tasks.

MIT ★ 110 updated 2026-10-19

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add alfredoperez/speckit-companion
/plugin install speckit-companion@speckit-companion
Open on GitHub

What speckit-companion does

The mod attaches an informational status bar above the prompt and a side panel with three tabs: Run, Overview, and Specs. It tracks pipeline phases, elapsed execution times, generated documents, and task progress. If your terminal window is at least 144 columns wide, the panel opens automatically alongside the session transcript.

Navigation relies on keyboard shortcuts: Tab and arrow keys switch between steps, Enter opens document previews inside the pane, and o launches your editor based on VISUAL or EDITOR variables.

This tool operates strictly in read-only mode, never modifying project files and transmitting zero telemetry. Claude Code 2.1.287 or later is required because earlier releases do not enable mod support by default.

What it helps with

  • track active Spec Kit pipeline progress without leaving the terminal
  • inspect generated spec documents and execution timestamps
  • switch focus across different specs using tracker commands
  • open referenced spec files quickly in an external editor

Example prompts for the agent

  • /speckit-tracker
  • /speckit-tracker export-csv
  • /spec auto

How to install speckit-companion

Plugin marketplace

/plugin marketplace add alfredoperez/speckit-companion
/plugin install speckit-companion@speckit-companion

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about speckit-companion

How to install speckit-companion in Claude Code?

Run /plugin marketplace add alfredoperez/speckit-companion followed by /plugin install speckit-companion@speckit-companion. In an active session, apply changes with /reload-plugins.

What does speckit-companion do?

It adds a status strip and an interactive terminal pane inside Claude Code to observe Spec Kit runs, showing completed phases, tasks, and document links.

Does speckit-companion modify files or require network access?

No, the mod is read-only: it reads local spec files without altering them, executes no remote network calls, and sends no telemetry.

Source text

claude-mod · MIT
# SpecKit Companion for Claude Code

Follow a [Spec Kit](https://github.com/github/spec-kit) run without leaving Claude Code. This [mod](https://code.claude.com/docs/en/plugins/mods/overview) adds a band above the prompt that says where the run stands, and a pane beside the transcript with the steps, their times, the documents and the tasks as they're ticked. It works with stock Spec Kit and with [SpecKit Companion](https://speckit-companion.dev).

![A Claude Code terminal with the mod's pane beside the transcript on its Run tab: Specify, Plan and Tasks ticked with their times, Implement running, the documents, and three of six tasks ticked. The band above the prompt names the spec and reads Plan done, Tasks 3/6, Implement running.](https://raw.githubusercontent.com/alfredoperez/speckit-companion/main/docs/screenshots/live-mod-window.png)

## Install

```bash
claude plugin marketplace add https://speckit-companion.dev/plugins/marketplace.json
claude plugin install speckit-companion@speckit-companion
```

You need Claude Code 2.1.287 or later, the first version with mods on by default. Check with `claude --version`.

In a session that is already open, run `/reload-plugins`. To update later, run `claude plugin update speckit-companion@speckit-companion`.

## First run

Open a project that has a spec. In a terminal at least 144 columns wide the pane opens by itself, and in a narrower one `/speckit-tracker` opens it above the prompt. It has three tabs: Run for the steps, documents and tasks, Overview for what the run recorded, and Specs to pick the spec to follow.

![The pane on its Run tab for Profile photo upload, Implementing. Specify, Plan and Tasks are ticked with their times, Implement reads running, six documents are listed with a read hint on each, the task bar reads 3/6, and tasks T001 to T003 are ticked under Phase 1. The foot lists the keys.](https://raw.githubusercontent.com/alfredoperez/speckit-companion/main/docs/screenshots/live-mod-run.png)

## Keys

| Key | What it does |
| --- | --- |
| `1` `2` `3` | Switch to Run, Overview or Specs |
| Tab or the arrow keys | Move between steps and documents |
| `↵` | Read the step or document you are on, inside the pane |
| `o` | Open that file in your editor |
| `b` | Go back from a document |
| `Esc` | Give the keyboard back to the prompt |

## Switch specs with `/speckit-tracker`

| You type | What happens |
| --- | --- |
| `/speckit-tracker` | The pane opens on its Specs tab |
| `/speckit-tracker 42` or `/speckit-tracker export-csv` | The band and the pane follow that spec |
| `/speckit-tracker auto` | They go back to following the most recently active spec |

Your pick is remembered for the project. `/spec` is a shorter name for the same command.

## What it reads, runs and sends

The mod only reads. It never writes a spec file or the run record, and it never sends a prompt, so you run the `/speckit-*` commands yourself.

- **Reads:** the spec files and the run record in your project, and four environment variables (`VISUAL`, `EDITOR`, `TERM_PROGRAM`, `CURSOR_TRACE_ID`) to pick your editor. It does not read the conversation.
- **Runs:** one program, your editor, and only when you press `o`. When no editor can be started, the file's path goes to your clipboard.
- **Sends:** nothing. The mod makes no network request and has no telemetry.

Tested on Claude Code 2.1.291. The mods API can change between releases.

<!-- other-products:start -->
## SpecKit Companion runs in four places

| Where | What it is | Start here |
|---|---|---|
| VS Code | The extension: a sidebar, a spec viewer and the Overview of every run. | [Install](https://speckit-companion.dev/docs/install) |
| Spec Kit | The engine half: records each step so every surface can show progress and resume. | [Install](https://speckit-companion.dev/docs/install) |
| GitHub Copilot app | A live spec board in the app's side panel. | [Copilot app](https://speckit-companion.dev/docs/copilot-app) |
| Claude Code | The followed spec's run above your prompt and in a pane. | [Claude Code](https://speckit-companion.dev/docs/claude-code) |
<!-- other-products:end -->

## Docs

[Guide](https://speckit-companion.dev/docs/claude-code) · [Changelog](./CHANGELOG.md) · [Develop](https://github.com/alfredoperez/speckit-companion/blob/main/apps/claude-mod/docs/develop.md) · MIT licensed.

© Alfredo Perez · MIT · alfredoperez/speckit-companion

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

speckit-companion by other authors comes first.

speckit-companion Alfredo Perez The speckit-companion GitHub Copilot plugin displays Spec Kit progress for each project spec. Open its documents or start the next stage from the board beside the chat. ★ 110repo stars speckit-analyze github-spec-kit speckit-analyze is a Claude Code skill that inspects consistency across spec.md, plan.md, and tasks.md. Runs strictly in read-only mode right before feature implementation starts. CX Codex +1 1,600installs speckit-implement github-spec-kit speckit-implement executes development tasks from tasks.md in spec-kit projects. It validates readiness checklists, triggers pre-implementation hooks, and configures ignore files. CX Codex +1 2,500installs spec-kit akillness Installs GitHub's specify CLI, bootstraps a spec-driven project for your agent, and runs the /speckit.* pipeline from constitution to implementation. CX Codex +1 167installs speckit.optimize Giuseppe Trisciuoglio speckit.optimize analyzes tasks.md to uncover blocking dependencies and generate a parallel subagent execution strategy. CX Codex +1 ★ 372repo stars speckit.check-integration Giuseppe Trisciuoglio speckit.check-integration reads tasks.md and flags tasks that overlap with code you already have, so you can reuse it instead of writing a second version. CX Codex +1 ★ 372repo stars speckit.implement Chat2AnyLLM The speckit.implement command works through the tasks in tasks.md using the project plan and related documents. Use it to carry out an implementation plan in a defined order. CX Codex +1 ★ 117repo stars

From the same set83

The whole set →
speckit.companion.living-adopt speckit.companion.living-adopt — a command for Claude Code and Codex that brings existing code under living specifications. CX Codex +1 ★ 110repo stars speckit.checklist speckit.checklist builds a custom checklist for the current feature and grades the requirements with it: completeness, clarity, edge cases. Handy before a spec review, not a code review. CX Codex +1 ★ 110repo stars speckit.companion.tasks speckit.companion.tasks generates a user-story phased task list and stamps tasking status into spec-kit feature context. CX Codex +1 ★ 110repo stars fix-tickets fix-tickets takes GitHub issues through an automated fix, review, PR, merge, and reporting cycle. Use it for sequential ticket work. CX Codex +1 ★ 110repo stars speckit.companion.plan speckit.companion.plan plans the implementation phase on Claude Code: collects a plan with research and design artifacts on top of stock spec-kit. Run it once the spec exists. CX Codex +1 ★ 110repo stars release-qa release-qa runs release-scoped QA on macOS for SpecKit Companion, tests UI and automated gates, and files a verdict report in Obsidian. CX Codex +1 ★ 110repo stars speckit.companion.implement The speckit.companion.implement command for Claude Code runs tasks.md in dependency order and keeps iterating toward convergence. It fires hooks around the implement phase. CX Codex +1 ★ 110repo stars speckit.companion.specify speckit.companion.specify is a Claude Code command that turns a feature description into a spec with prioritized user stories. It is the entry point for creating fresh project specs. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open