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
• Statistics Dashboard — KPI metrics, completion charts, and task progress timeline
• 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
• Performance Optimized — Lazy loading for archived changes and in-memory caching for faster load times

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.2.0

Added performance optimizations with lazy loading for archived changes, in-memory caching of scan results, and skeleton loading UI for smoother experience.

1.1.1

Added dashboard quick action to the OpenSpec Pro sidebar title menu.

1.1.0

Added Statistics Dashboard with KPI metrics, completion charts, and task progress timeline. Added Delete Draft Change feature for removing unwanted drafts with confirmation.

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