Skip to content

Feature: add specify status command#1837

Open
KhawarHabibKhan wants to merge 3 commits intogithub:mainfrom
KhawarHabibKhan:add-status-command
Open

Feature: add specify status command#1837
KhawarHabibKhan wants to merge 3 commits intogithub:mainfrom
KhawarHabibKhan:add-status-command

Conversation

@KhawarHabibKhan
Copy link
Contributor

Summary

  • Adds a new specify status CLI command that shows a unified project overview
  • Detects AI agent(s) configured in the project by scanning for known agent folders
  • Shows current feature (from git branch, SPECIFY_FEATURE env var, or specs/ scan)
  • Lists SDD artifacts with existence status (spec.md, plan.md, tasks.md, research.md, data-model.md, quickstart.md, contracts/, checklists/)
  • Parses tasks.md for completion progress (e.g., "12/18 completed (67%)")
  • Detects current workflow phase (Not Started → Plan → Tasks → Implement → Complete)
  • Shows extensions summary (installed count + available in catalog)

Motivation

There is currently no way to see the overall state of a spec-kit project from the CLI. Users must manually check git branches, the file system, and run separate extension commands. This fills that gap — similar to how git status provides a project snapshot.

@mnriem
Copy link
Collaborator

mnriem commented Mar 13, 2026

Please deliver this as an extension or does the Project Health extension already fit the bill? See https://github.com/github/spec-kit/tree/main/extensions#available-community-extensions

@mnriem
Copy link
Collaborator

mnriem commented Mar 13, 2026

As in can you add it to it?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants