Repository navigation
Closed
Labels
extension-submissiontriage-must-haveVerdict: high-value, important work for Spec Kit — do firstVerdict: high-value, important work for Spec Kit — do firstvalidation-passed
Description
Extension ID
companion
Extension Name
SpecKit Companion
Version
0.26.0
Description
Records your spec-kit runs live: status, resume, and a health check for what actually happened.
Author
alfredoperez
Repository URL
https://github.com/alfredoperez/speckit-companion
Download URL
License
MIT
Homepage (optional)
https://github.com/alfredoperez/speckit-companion/tree/main/apps/speckit-extension
Documentation URL (optional)
https://github.com/alfredoperez/speckit-companion/blob/main/apps/speckit-extension/README.md
Changelog URL (optional)
https://github.com/alfredoperez/speckit-companion/blob/main/apps/speckit-extension/CHANGELOG.md
Required Spec Kit Version
=1.2.5.dev0
Required Tools (optional)
- `python3` (optional)Number of Commands
26
Number of Hooks (optional)
10
Tags
vscode, progress, living-specs, drift, hooks
Key Features
- Every spec records what was proven — your request word for word, who made each decision, assumed and weakly tested requirements, the commit each check ran on, and a risk tier
- Receipts for the pull request — each check is kept with its exit code, so a PR body can show what ran and what the agent only claimed
- A clean converge completes the spec — converge records the tasks each pass added, and a pass that adds none finishes the spec
- Works with stock Spec Kit 1.2.5 — new specs are
spec.md, your template overrides and presets shape Companion runs, and plain/speckit.*commands stay exactly as shipped - Step times from the agent's own events — typing a step command records its start, and a step closes only when its document is really written
- Safe in parallel and in monorepos — spec numbers are picked under a lock and follow
feature_numbering, and the project is found the way Spec Kit finds it - The plan draws what a change touches — call paths, pinned code, states or screens are added only when the change needs them, and each is checked
- Doctor and status — doctor flags missing Companion commands, a missing
specifyCLI and shared spec numbers; status prints where each spec stands
Testing Checklist
- Extension installs successfully via download URL
- All commands execute without errors
- Documentation is complete and accurate
- No security vulnerabilities identified
- Tested on at least one real project
Submission Requirements
- Valid
extension.ymlmanifest included - README.md with installation and usage instructions
- LICENSE file included
- GitHub release created with version tag
- All command files exist and are properly formatted
- Extension ID follows naming conventions (lowercase-with-hyphens)
Testing Details
Tested on Darwin 27.0.0 with Spec Kit 1.3.2 (installed with uvx from the v1.3.2 tag).
- Installed v0.26.0 from the release download into a fresh
specify init --integration claudeproject;specify extension listshows SpecKit Companion v0.26.0. - Ran a real feature through specify, plan, tasks, implement and converge with Claude Code in a terminal (4m 30s) and from VS Code (7m 53s); both ended completed with a clean run record.
- The extension's own suite passes (Python unit tests, shape parity, build check).
Example Usage
# Install (Spec Kit 1.2.5 or newer)
specify extension add companion --from https://github.com/alfredoperez/speckit-companion/releases/download/companion-latest/companion.zip
# Run the whole pipeline hands-off on a new feature
/speckit.companion.auto Add a dark mode toggle to settings that survives a reload
# Or step by step
/speckit.companion.specify Add a dark mode toggle to settings
/speckit.companion.plan
/speckit.companion.tasks
/speckit.companion.implement
# See where every spec stands, and check the install
/speckit.companion.status
/speckit.companion.doctorProposed Catalog Entry
{
"companion": {
"name": "SpecKit Companion",
"id": "companion",
"description": "Records your spec-kit runs live: status, resume, and a health check for what actually happened.",
"author": "alfredoperez",
"version": "0.26.0",
"download_url": "https://github.com/alfredoperez/speckit-companion/releases/download/speckit-ext-v0.26.0/companion-0.26.0.zip",
"sha256": "e385885cfb6e1254945da902295b4587b74050334109eb9b17c2446e285273c0",
"repository": "https://github.com/alfredoperez/speckit-companion",
"homepage": "https://github.com/alfredoperez/speckit-companion/tree/main/apps/speckit-extension",
"documentation": "https://github.com/alfredoperez/speckit-companion/blob/main/apps/speckit-extension/README.md",
"changelog": "https://github.com/alfredoperez/speckit-companion/blob/main/apps/speckit-extension/CHANGELOG.md",
"license": "MIT",
"category": "process",
"effect": "read-write",
"requires": {
"speckit_version": ">=1.2.5.dev0",
"tools": [
{
"name": "python3",
"required": false
}
]
},
"provides": {
"commands": 26,
"hooks": 10
},
"tags": [
"vscode",
"progress",
"living-specs",
"drift",
"hooks"
],
"verified": false,
"downloads": 0,
"stars": 0,
"created_at": "2026-06-11T00:00:00Z",
"updated_at": "2026-11-09T00:00:00Z"
}
}Additional Context
Update from v0.24.0 (#4857) to v0.26.0. The extension now requires Spec Kit 1.2.5 or newer, the oldest CLI with every feature it uses.
Metadata
Metadata
Assignees
Labels
extension-submissiontriage-must-haveVerdict: high-value, important work for Spec Kit — do firstVerdict: high-value, important work for Spec Kit — do firstvalidation-passed
Activity
github-actions commentedon Nov 9, 2026
cc @github/spec-kit-maintainers — new catalog submission for review.
github-actions commentedon Nov 9, 2026
Validation failed for this extension submission.
Failed check:
https://github.com/alfredoperez/speckit-companion/releases/download/speckit-ext-v0.26.0/companion-0.26.0.zipsha256:8bfbe27dbe2d67e525820f83340c053341836f108d2ff087c10fdc8295b07da9sha256:e385885cfb6e1254945da902295b4587b74050334109eb9b17c2446e285273c0How to fix:
Workflow run
alfredoperez commentedon Nov 9, 2026
Fixed: the checksum in the catalog entry above is now
e385885cfb6e1254945da902295b4587b74050334109eb9b17c2446e285273c0, the sha256 of the release asset at the submitted URL. My submission tool had carried over the 0.24.0 checksum instead of recomputing it; that's fixed on our side too. The validation runs when theextension-submissionlabel is added, so it needs a maintainer to re-apply it. Sorry for the noise.Update SpecKit Companion extension to v0.26.0
github-actions commentedon Nov 10, 2026
Pull request created: #5365
Update SpecKit Companion extension to v0.26.0 (#5365)