Releases: Fission-AI/OpenSpec
Release list
v1.7.0 - New tools, smarter updates
What's New in v1.7.0
Ninety merged PRs from nineteen contributors. New tools, sturdier archives, and a CLI that keeps itself fresh.
New
openspec updatekeeps you current - It now checks npm for a newer release and offers to run the upgrade for you. One less thing to remember.- Five new AI tools - Welcome ZCode, Hermes Agent, CodeArts Agent, and Kimi Code; Codex now runs skills-only. And if skills.sh is your thing,
npx skills add Fission-AI/OpenSpecworks too. - One default store for your whole machine -
openspec config set defaultStore <id>and every repo without its own config resolves through it. - Changes without spec changes - Pure refactors and docs work can declare
skip_specs: trueand move straight through validate and archive. - Project context in every workflow - Schemas can carry per-operation guidance, and
openspec instructions apply|archiveserve it to your agent right when it needs it.
Improved
- Slash commands, spelled the way your tool spells them - Generated content now matches each tool's registered command names across all 30+ supported tools.
- Archives flow - Already-synced deltas glide through as no-ops, your authored
## Purposecarries into new specs, and dated names stay tidy on re-archive. - Multi-select prompts got proper checkboxes -
[x]for multi-select, exactly as your fingers expect. - A welcome screen for everyone - Honors your OS Reduce Motion setting,
--no-animation, and waits politely for Enter. - Nested spec folders everywhere -
specs/<area>/<capability>/spec.mdis first-class in validate, apply, archive, and view.
Fixed
- Leaner, policy-friendly installs - Telemetry now sends its single event with a plain fetch, so installs are ~160 packages lighter and sail through supply-chain age policies like pnpm's
minimumReleaseAge(#1390). - Completions everywhere you shell - fish gets true fish completions, PowerShell scripts parse cleanly, and Oh My Zsh installs land in your actual
$ZSH. - Windows input flows smoothly - keystrokes register immediately after the welcome screen.
openspec feedbackalways delivers - your message reaches an issue or a ready-to-send link, whatever gh is up to.- Files from every editor parse - UTF-8 BOMs from Windows editors are handled transparently.
- Change names with leading digits -
0001-add-authis valid everywhere, matching the archive conventions.
Want every detail? All 79 changes are itemized in the CHANGELOG.
Thanks
Every PR in this release, big or small, made it better:
@TabishB, @showms, @mc856, @hsusul, @xiaoquisme, @vishnujayvel, @taltas, @nmrtn, @mehdishahdoost, @jikkujoyce, @javigomez, @fyeeme, @c4patino, @benjymoses, @akeyz, @Lukk17, @HowardYan888, @CodeArtsAgent, @clay-good
New Contributors
- @javigomez made their first contribution in #1151
- @akeyz made their first contribution in #1208
- @xiaoquisme made their first contribution in #1292
- @fyeeme made their first contribution in #1209
- @mc856 made their first contribution in #1191
- @CodeArtsAgent made their first contribution in #1266
- @showms made their first contribution in #1283
- @vishnujayvel made their first contribution in #1391
- @benjymoses made their first contribution in #1299
- @nmrtn made their first contribution in #1109
- @Lukk17 made their first contribution in #1255
- @taltas made their first contribution in #1428
- @c4patino made their first contribution in #1455
- @hsusul made their first contribution in #1447
- @jikkujoyce made their first contribution in #1469
- @mehdishahdoost made their first contribution in #1167
Full Changelog: v1.6.0...v1.7.0
v1.6.0 - OPSX Update, Tool Support
What's New in v1.6.0
This release adds a safer way to revise plans in place, expands tool support, and hardens validation, archiving, and store setup.
New
- Update planning artifacts - Use
/opsx:updateto revise an existing change's plan and reconcile related artifacts without crossing into implementation work. - Oh My Pi support - Generate native OPSX commands and skills for Oh My Pi projects, with automatic tool detection and the expected
.omplayout. - TRAE support - Generate
.trae/commands/opsx-<id>.mdcommands for TRAE projects.
Improved
- Generated skill permissions - Generated skills and Claude commands can pre-approve the OpenSpec CLI, avoiding repeated confirmation prompts while leaving other tools under normal permission controls.
- Requirement handling - Validation now reads fenced examples, metadata, multi-line descriptions, nested deltas, and normative keywords more consistently across changes and main specs.
Fixed
- Fresh stores - Newly created stores can be registered and used before empty changes, specs, or archive directories have been committed.
- Archive safety - Stale
MODIFIEDrequirements stop instead of silently deleting scenarios added by an earlier archive. - Resolution and task progress -
validate,view,list, and archive checks now agree on change resolution and correctly handle nested specs and task files. - Archive failure signaling - Blocked human-mode archive operations now exit non-zero, so scripts and CI no longer interpret validation failures as success.
New Contributors
- @danilopopeye made their first contribution in #1311
- @ercanerdogan made their first contribution in #1261
- @jjxyxsjr made their first contribution in #1090
- @xianzheTM made their first contribution in #1276
Full Changelog: v1.5.0...v1.6.0
v1.6.0-beta.1
Beta prerelease. Install with npm install -g @fission-ai/openspec@beta.
What's Changed
- fix(resolution): converge validate, view, and archive onto canonical resolution (#1182, #1202, #1156) by @clay-good in #1280
- docs: add cloudflare documentation deployment website by @clay-good in #1285
- Fix
archiveexit code on validation failure by @danilopopeye in #1311 - feat(skills): propose /opsx:update planning-artifact update skill by @clay-good in #1278
- refactor: unify requirement reader and surface #498 by @clay-good in #1281
- feat(skills): auto-approve the openspec CLI in generated skills and commands by @clay-good in #1300
- fix archive scenario drift for #1246 by @zhangsan582 in #1252
- docs: clarify change name format by @ercanerdogan in #1261
- chore: remove stale npm lockfile by @TabishB in #1319
- feat: add Trae command adapter by @jjxyxsjr in #1090
- feat: add Oh My Pi (OMP) tool support by @xianzheTM in #1276
- chore: remove scheduled docs workflow by @TabishB in #1324
- Fix Windows CI flake hardening by @TabishB in #1325
- ci(release): add beta prerelease workflow by @clay-good in #1327
- fix(stores): allow empty store registration by @TabishB in #1328
New Contributors
- @danilopopeye made their first contribution in #1311
- @ercanerdogan made their first contribution in #1261
- @jjxyxsjr made their first contribution in #1090
- @xianzheTM made their first contribution in #1276
Full Changelog: v1.5.0...v1.6.0-beta.1
v1.5.0 - Stores Beta
What's New in v1.5.0
Stores arrives in very early beta — a simpler model for organizing specs and changes — alongside a couple of generation and config fixes.
New
- Stores (very early beta) - A simpler way to organize specs and changes, replacing the workspace and initiative model. Still rough — expect breaking changes while it stabilizes.
Fixed
- Config parsing - Configuration values wrapped in JSON containers are now parsed correctly.
- YAML frontmatter - Carriage returns in generated command descriptions are now escaped instead of written literally, which could silently corrupt CRLF-authored values.
New Contributors
- @clay-good made their first contribution in #1237
- @zied-jlassi made their first contribution in #1240
- @zhangsan582 made their first contribution in #1244
Full Changelog: v1.4.1...v1.5.0
v1.4.1 - Update Fix
What's New in v1.4.1
Fixed
openspec update- Projects with their ownworkspace.yaml(like Dagster) now runopenspec updatenormally again.
v1.4.0 - Kimi CLI, Mistral Vibe
What's New in v1.4.0
Two new agent integrations — Kimi CLI and Mistral Vibe — plus sync skills enabled by default and a round of parsing and shell fixes.
New
- Kimi CLI support - Initialize Kimi CLI as a skills-only tool. OpenSpec skills land in
.kimi/skills/for use via/skill:openspec-*. - Mistral Vibe support - Initialize Mistral Vibe as a skills-only tool, with skills generated under
.vibe/skills/. - Sync skills by default - New installs now generate
/opsx:syncskills and commands out of the box in the core profile.
Improved
- Clearer validation hints - When a requirement has SHALL/MUST only in its header,
openspec validatenow tells you to move the keyword onto the requirement body line instead of showing a generic error.
Fixed
- Case-insensitive requirement headers - Requirement headers now parse regardless of capitalization, so specs no longer fail over header casing.
- Zsh completions on oh-my-zsh - Tab completion now installs correctly under oh-my-zsh's
compinitsetup.
New Contributors
- @Miss-you made their first contribution in #1003
- @davseby made their first contribution in #1031
- @JiangWay made their first contribution in #1043
- @HowardYan888 made their first contribution in #1059
- @Pluviobyte made their first contribution in #1135
Full Changelog: v1.3.1...v1.4.0
v1.3.1 - Path & Telemetry Fixes
What's New in v1.3.1
A batch of path resolution and telemetry reliability fixes for workflow artifacts, validation, and locked-down networks.
Fixed
- Canonical artifact paths - Workflow artifact paths now resolve through the native
realpath, so symlinks and case-insensitive filesystems no longer cause mismatches during apply and archive. - Glob artifact outputs - Apply instructions with glob artifact outputs resolve correctly. Literal outputs are enforced as file paths.
- Hidden spec requirements - Validation now detects requirements nested inside fenced code blocks or otherwise hidden in main specs.
- Clean
--jsonoutput - Spinner progress no longer leaks into stderr when--jsonis passed, so agents parsing combined stdout/stderr get clean JSON. - Silent telemetry in firewalled networks - PostHog errors are swallowed with a 1s timeout and retries/remote config disabled, so
PostHogFetchNetworkErrorno longer appears in locked-down environments. Telemetry opt-out is documented earlier in the README, install guide, and CLI reference. - Telemetry config on XDG and Windows - Honors
XDG_CONFIG_HOMEon Linux and%APPDATA%on Windows when locating the telemetry config file. - Glob-special characters in paths - Directory paths containing glob metacharacters are now escaped before matching.
New Contributors
Full Changelog: v1.3.0...v1.3.1
v1.3.0 - New Tool Integrations
What's New in v1.3.0
New tool integrations plus targeted fixes for OpenCode, Copilot, and pi.dev.
New
- Junie support - Generate tool and command files for JetBrains Junie.
- Lingma IDE support - Configuration support for Lingma IDE.
- ForgeCode support - Tool support for ForgeCode.
- IBM Bob support - Tool support for IBM Bob coding assistant.
Fixed
- OpenCode directory - OpenCode adapter now uses
.opencode/commands/(plural) to match OpenCode's official convention. openspec statuswith no changes - Exits gracefully instead of throwing when no changes exist.- Copilot auto-detection - No longer triggers from a bare
.github/directory with no Copilot config. - pi.dev command generation - Command reference transforms and template argument passing now work correctly.
- Shell completions opt-in - Completion install is now opt-in, avoiding PowerShell encoding corruption.
New Contributors
- @JabinGP made their first contribution in #763
- @fsilvaortiz made their first contribution in #761
- @alleninnz made their first contribution in #917
- @mission-deny-the-mission made their first contribution in #941
- @gregoralbrecht made their first contribution in #882
- @mrack688 made their first contribution in #864
- @kunzaatko made their first contribution in #892
- @preigile made their first contribution in #853
- @rdruss made their first contribution in #886
Full Changelog: v1.2.0...v1.3.0
v1.2.0 - Profiles, Pi & Kiro Support
What's New in v1.2.0
Control what gets installed with profiles, create complete change proposals in one step, and use OpenSpec with two new coding agents.
New
- Profiles — Choose between
core(4 essential workflows) andcustom(pick any subset) to control which skills get installed. Manage withopenspec config profile. - Propose workflow — Create a complete change proposal with design, specs, and tasks from a single request — no need to run
newthenffseparately. - Pi support — Pi (pi.dev) coding agent is now a supported tool with prompt and skill generation.
- Kiro support — AWS Kiro IDE is now a supported tool with prompt and skill generation.
- AI tool auto-detection —
openspec initscans your project for existing tool directories (.claude/,.cursor/, etc.) and pre-selects detected tools.
Improved
- Sync prunes deselected workflows —
openspec updatenow removes command files and skill directories for workflows you've deselected, keeping your project clean. - Config drift warning —
openspec config listwarns when global config is out of sync with the current project.
Fixed
- Onboard preflight no longer gives a false "not initialized" error on freshly initialized projects
- Archive workflow no longer stops mid-way when syncing — it properly resumes after sync completes
- Added Windows PowerShell alternatives for onboard shell commands
New Contributors
- @cheolwanpark made their first contribution in #632
- @0mega made their first contribution in #644
- @wenxiaoyu made their first contribution in #646
- @anilkmr-a2z made their first contribution in #707
- @carlosapgomes made their first contribution in #735
Full Changelog: v1.1.1...v1.2.0
v1.1.1 - OpenCode Command Fix
What's New in v1.1.1
A quick patch to fix OpenCode command references.
Fixed
- OpenCode command references - Generated files now use the correct
/opsx-hyphen format instead of/opsx:colon format, so commands work properly in OpenCode
New Contributors
Full Changelog: v1.1.0...v1.1.1