Fission AI Release Notes

What's New in v1.1.0

A stability release focused on fixing cross-platform path issues and improving the Nix build experience.

Fixed

• Codex global paths - Codex adapter now resolves global paths correctly, fixing workflow file generation when run outside the project directory
• Archive on networked/external drives - Archive falls back to copy+remove when rename fails with EPERM or EXDEV errors
• Windsurf workflow path - Updated Windsurf adapter to use the correct workflows directory instead of the legacy commands path
• Slash command hints - Workflow completion messages now display helpful slash command hints for next steps

Improved

• Nix flake - Version now read dynamically from package.json; source filtering excludes node_modules for faster builds
• Nix CI - Updated to latest nix-installer and magic-nix-cache actions

New Contributors

• @jerome-benoit made their first contribution in #550
• @moe1214 made their first contribution in #601
• @CosticaPuntaru made their first contribution in #605
• @Haven-S made their first contribution in #616
• @yangjuncode made their first contribution in #610
• @CS-Tao made their first contribution in #603

What's New in v1.0.0

OpenSpec 1.0 marks the transition from experimental to stable. The workflow has been rebuilt around an action-based system where AI understands your project's state—what artifacts exist, what's ready to create, and what each action unlocks.

---

⚠️ Migrating from Pre-1.0

Breaking changes:

• Old commands removed — /openspec:proposal, /openspec:apply, /openspec:archive no longer exist
• Config files removed — Tool-specific files (CLAUDE.md, .cursorrules, AGENTS.md, project.md) are no longer generated

To upgrade: Run openspec init. Your existing work is safe—active changes, archived changes, and main specs are all preserved. Only obsolete config files are cleaned up (with confirmation).

→ Migration guide

---

New

• Action-based workflow — Replaced the rigid proposal → apply → archive sequence with flexible actions. Edit any artifact anytime. The artifact graph tracks state automatically.

Command	What it does
/opsx:explore	Think through ideas before committing to a change
/opsx:new	Start a new change
/opsx:continue	Create one artifact at a time (step-through)
/opsx:ff	Create all planning artifacts at once (fast-forward)
/opsx:apply	Implement tasks
/opsx:verify	Validate implementation matches artifacts
/opsx:sync	Sync delta specs to main specs

What's New in v0.22.0

OpenSpec now supports per-project configuration, letting you customize behavior and define schemas for project-specific workflows. (Still very experimental, feedback appreciated!)

More docs available here (search for schema and/or config): https://github.com/Fission-AI/OpenSpec/blob/main/docs/experimental-workflow.md

New

• Project configuration - Configure OpenSpec per-project with openspec/config.yaml to inject custom rules, specify context files, and control schema resolution
• Project-local schemas - Define custom artifact schemas in openspec/schemas/ for project-specific workflows
• Schema management - Inspect and manage artifact schemas with new openspec schema commands (list, show, export, validate)

Fixed

• Config loading now handles null rules field without errors

What's New in v0.21.0

This release adds better feedback tooling and Nix support, plus guardrails to keep exploration focused.

New

• Feedback command - Submit feedback directly from the CLI with openspec feedback. Creates GitHub Issues with automatic metadata or provides a manual submission link if that fails.
• Nix flake support - Install and develop OpenSpec using Nix with flake.nix, including automated maintenance and CI validation.

Improved

• Change inference in opsx apply - Automatically detects which change to apply from conversation context, prompts when ambiguous.
• Archive sync assessment - Clearer guidance on delta spec locations during sync operations.

Fixed

• Explore mode guardrails - Explore mode now explicitly prevents implementation to keep focus on thinking and discovery.

New Features

• Continue IDE support – OpenSpec now generates slash commands for Continue, expanding editor integration options alongside Cursor, Windsurf, Claude Code, and others
• Shell completions for Bash, Fish, and PowerShell – Run openspec completion install to set up tab completion in your preferred shell
• /opsx:explore command – A new thinking partner mode for exploring ideas and investigating problems before committing to changes
• Codebuddy slash command improvements – Updated frontmatter format for better compatibility

Bug Fixes

• Shell completions now correctly offer parent-level flags (like --help) when a command has subcommands
• Fixed Windows compatibility issues in tests

Other

• Added optional anonymous usage statistics to help understand how OpenSpec is used. This is opt-out by default – set OPENSPEC_TELEMETRY=0 or DO_NOT_TRACK=1 to disable. Only command names and version are collected; no arguments, file paths, or content. Automatically disabled in CI environments.

Minor Changes

• 8dfd824: Add OPSX experimental workflow commands and enhanced artifact system

  New Commands:

  • /opsx:ff - Fast-forward through artifact creation, generating all needed artifacts in one go
  • /opsx:sync - Sync delta specs from a change to main specs
  • /opsx:archive - Archive completed changes with smart sync check

  Artifact Workflow Enhancements:

  • Schema-aware apply instructions with inline guidance and XML output
  • Agent schema selection for experimental artifact workflow
  • Per-change schema metadata via .openspec.yaml files
  • Agent Skills for experimental artifact workflow
  • Instruction loader for template loading and change context
  • Restructured schemas as directories with templates

  Improvements:

  • Enhanced list command with last modified timestamps and sorting
  • Change creation utilities for better workflow support

  Fixes:

  • Normalize paths for cross-platform glob compatibility
  • Allow REMOVED requirements when creating new spec files