Skip to content

[Extension]: Add SpecKit Companion v0.26.0 (catalog update) #5324

Closed

Description

@alfredoperez

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

https://github.com/alfredoperez/speckit-companion/releases/download/speckit-ext-v0.26.0/companion-0.26.0.zip

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 specify CLI 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.yml manifest 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 claude project; specify extension list shows 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.doctor

Proposed 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.

Activity

  1. github-actions commented on Nov 9, 2026

    @github-actions
    Contributor

    cc @github/spec-kit-maintainers — new catalog submission for review.

  2. github-actions commented on Nov 9, 2026

    @github-actions
    Contributor

    Validation failed for this extension submission.

    Failed check:

    • SHA-256 checksum mismatch for the submitted download URL:
      • URL: https://github.com/alfredoperez/speckit-companion/releases/download/speckit-ext-v0.26.0/companion-0.26.0.zip
      • Submitted sha256: 8bfbe27dbe2d67e525820f83340c053341836f108d2ff087c10fdc8295b07da9
      • Actual downloaded archive sha256: e385885cfb6e1254945da902295b4587b74050334109eb9b17c2446e285273c0

    How to fix:

    1. Regenerate the checksum from the exact release asset at the submitted URL.
    2. Update the issue submission so the checksum matches that asset exactly.
    3. Re-run validation.

    Workflow run

    Generated by 🧩 Add Community Extension from Issue Submission for #5324 · copilot · gpt53codex · 15.7 AIC · ⌖ 0.647 AIC · ⊞ 28.5K · ◷

  3. alfredoperez commented on Nov 9, 2026

    @alfredoperez
    ContributorAuthor

    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 the extension-submission label is added, so it needs a maintainer to re-apply it. Sorry for the noise.

  4. added a commit that references this issue on Nov 10, 2026
    9e49ef1
  5. github-actions commented on Nov 10, 2026

    @github-actions
    Contributor

    Pull request created: #5365

    Generated by Add Community Extension from Issue Submission · copilot · gpt53codex · 32 AIC · ⌖ 0.694 AIC · ⊞ 27.1K

  6. added a commit that references this issue on Nov 10, 2026
    324fb57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions