Skip to content

[Extension]: Add spec-kit-switch #3932

Open

Description

@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"
  }
}

Activity

  1. MannXo commented on Aug 1, 2026

    @MannXo
    Contributor

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

  2. wagner-sousa commented on Aug 1, 2026

    @wagner-sousa
    Author

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

    OK

  3. mnriem commented on Aug 3, 2026

    @mnriem
    Collaborator

    @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

  4. self-assigned this
    on Aug 6, 2026
  5. github-actions commented on Aug 7, 2026

    @github-actions
    Contributor

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

  6. added a commit that references this issue on Aug 7, 2026
    ae61b31
  7. github-actions commented on Aug 7, 2026

    @github-actions
    Contributor

    Pull request created: #4009

    Generated by Add Community Extension from Issue Submission · 304.1 AIC · ⌖ 16.4 AIC · ⊞ 35.2K

  8. KSchlobohm commented on Aug 7, 2026

    @KSchlobohm
    Contributor

    @wagner-sousa @MannXo the review found that the tagged artifact at this download URL does not implement the submitted v1.0.0 feature set.

  9. github-actions commented on Oct 11, 2026

    @github-actions
    Contributor

    This issue has been automatically marked as stale because it has had no activity for 60 days. It will be closed in 30 days unless there is a substantive update. If the problem still applies, please provide updated context such as whether it is still reproducible, the affected version or environment, its current impact, and any new reproduction details. A comment that only states that the issue is "still relevant" does not give maintainers enough information to reconsider it.

  10. added
    triage-must-haveVerdict: high-value, important work for Spec Kit — do first
    on Oct 15, 2026
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