OpenSpec Pro

OpenSpec Pro brings spec-driven development workflows directly into your editor. Manage OpenSpec repositories, navigate changes, and execute workflows without leaving VS Code—all powered by local filesystem operations.

Perfect for teams using spec-first development practices. Works seamlessly across VS Code, VSCodium, Cursor, Windsurf, Trae, Kiro, Qoder, and other VS Code-compatible editors.

Screenshots

Features

• Workspace Dashboard — View all active and archived changes at a glance
• Change Management — Create, view, and archive changes directly from the sidebar
• Artifact Navigation — Browse proposals, designs, specs, and tasks with built-in Markdown rendering
• Task Tracking — Toggle task completion status from the UI without editing files
• Workspace Diagnostics — Troubleshoot repository state with detailed diagnostics
• Local-First Workflow — All operations work on the local filesystem—no CLI required
• Multi-Editor Support — Works on VS Code, Cursor, Windsurf, Trae, Kiro, Qoder, and compatible editors

Commands

OpenSpec Pro contributes the following commands to your command palette:

The OpenSpec Pro sidebar also exposes quick actions:

• Refresh — Rescan the workspace for changes
• New Change — Create a new change with a kebab-case name

Requirements

• VS Code 1.90.0 or later (or compatible editor)
• An OpenSpec workspace — Either an existing repository with OpenSpec structure, or a workspace you want to bootstrap

Supported Editors

OpenSpec Pro works on any VS Code-compatible editor that preserves the extension API:

• Visual Studio Code
• VSCodium
• Cursor
• Windsurf
• Trae
• Kiro
• Qoder
• Other VS Code forks

Getting Started

1. Install the extension from the VS Code Marketplace
2. Open a workspace folder containing an OpenSpec repository (or create a new one)
3. Click the OpenSpec Pro icon in the activity bar to open the sidebar
4. Bootstrap your workspace (if needed) using the command palette: OpenSpec Pro: Bootstrap Workspace
5. Start managing changes — Create, view, and archive changes directly from the UI

How It Works

OpenSpec Pro reads and writes to the standard OpenSpec directory structure:

your-workspace/
├── openspec/
│   ├── config.yaml          # Workspace configuration
│   ├── changes/             # Active changes
│   │   └── my-change/
│   │       ├── proposal.md
│   │       ├── design.md
│   │       ├── spec.md
│   │       └── tasks.md
│   └── specs/               # Archived changes

All operations are local-first and filesystem-based. No cloud sync, no CLI required.

Known Issues

• This release focuses on local workspace workflows and does not replace every OpenSpec CLI capability
• Built-in AI execution and cloud workflow orchestration are out of scope for this release
• Some advanced OpenSpec features may require the CLI

Troubleshooting

Extension not showing in sidebar?

• Ensure you have a workspace folder open
• Check the Output panel (OpenSpec Pro) for error messages
• Try running OpenSpec Pro: Reindex Workspace from the command palette

Changes not appearing?

• Verify your workspace has the correct OpenSpec structure
• Run OpenSpec Pro: Show Diagnostics to check repository state
• Try OpenSpec Pro: Bootstrap Workspace to initialize the structure

Tasks not saving?

• Ensure the workspace folder has write permissions
• Check the Output panel for error details

Contributing

Found a bug or have a feature request? Open an issue on GitHub.

Support

For questions and discussions, visit the OpenSpec community.

Release Notes

1.1.0

Added Delete Draft Change feature — remove unwanted draft changes directly from the UI with confirmation dialog.

1.0.0

First stable release with marketplace-ready icon, comprehensive documentation, and screenshot previews.

See CHANGELOG.md for the full release history.

License

MIT