If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run
openspec store list --json
to discover registered store ids, then pass
--store
on the commands that read or write specs and changes (
new change
,
status
,
instructions
,
list
,
show
,
validate
,
archive
,
doctor
,
context
,
schemas
,
view
). Once selected, treat
--store
as sticky for the rest of the workflow. Every unscoped example of those commands below is shorthand: before running it, append the flag. For example, run
openspec status --change "" --json --store ""
, not the unscoped form shown below. Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local
openspec/
root.
Input
Optionally specify a change name (e.g.,
/openspec-apply-change add-auth
). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
Steps
Select the change
If a name is provided, use it. Otherwise:
Infer from conversation context if the user mentioned a change
Auto-select if only one active change exists
If ambiguous, run
openspec list --json
to get available changes and ask the user to select one
Always announce: "Using change: " and how to override (e.g.,
/openspec-apply-change
).
Show more
Installs
962
Repository
fission-ai/openspec
GitHub Stars
66.6K
First Seen
Jul 17, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Warn