[Extension]: Add spec-kit-switch

[wagner-sousa]

Extension ID

switch

Extension Name

Spec Switcher

Version

1.0.0

Description

Navigate between specs — list available specs and switch active feature with git checkout

Author

Wagner Sousa

Repository URL

https://github.com/wagner-sousa/spec-kit-switch

Download URL

https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip

License

MIT

Homepage

https://github.com/wagner-sousa/spec-kit-switch

Documentation URL

https://github.com/wagner-sousa/spec-kit-switch#readme

Changelog URL

https://github.com/wagner-sousa/spec-kit-switch/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.4.0

Number of Commands

2

Number of Hooks

0

Tags

navigation, workflow, specs, sdd, git

Key Features

• List all available specs with branch and active status in a table
• Switch between specs via git checkout (avoids feature.json conflicts)
• Auto-unlock previous spec lifecycle on switch via cross-plugin interface
• --local-only flag for branchless specs

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 Linux with Spec Kit v0.13.3 in the spec-kit-docker template project. Both commands verified: switch.list shows all specs with branch/status table, switch.set performs git checkout with auto-unlock of previous spec. Cross-plugin interface tested with lifecycle extension for seamless spec transitions.

Example Usage

specify extension add switch --from https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip
/speckit.switch.list
/speckit.switch.set 013

Proposed Catalog Entry

{
  "switch": {
    "name": "Spec Switcher",
    "id": "switch",
    "description": "Navigate between specs — list available specs and switch active feature with git checkout",
    "author": "Wagner Sousa",
    "version": "1.0.0",
    "download_url": "https://github.com/wagner-sousa/spec-kit-switch/archive/refs/tags/v1.0.0.zip",
    "repository": "https://github.com/wagner-sousa/spec-kit-switch",
    "homepage": "https://github.com/wagner-sousa/spec-kit-switch",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.4.0"
    },
    "provides": {
      "commands": 2
    },
    "tags": ["navigation", "workflow", "specs", "sdd", "git"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-07-31T00:00:00Z",
    "updated_at": "2026-07-31T00:00:00Z"
  }
}

[MannXo]

Can I take this? I have some time to work on it this week.

[wagner-sousa]

Can I take this? I have some time to work on it this week.

OK

[mnriem]

@wagner-sousa @MannXo This will go through agentic workflow as it needs to validate certain requirements. If anything does pop up for that you are more than welcome to address it, but I bet @wagner-sousa would then have to address things as it would be on the extension side