OpenSpec - Lightweight & portable spec driven framework for AI coding assistants!

Hey Cursor friends! Just released something that might save your sanity

Ever been here?

  • 5 prompts deep, AI still missing the mark
  • Requirements scattered across chat history
  • Hours lost in endless course-correction cycles

That’s why I built OpenSpec - an open-source CLI that plays beautifully with Cursor’s custom slash commands.

What OpenSpec Gives You

  • Structure before code - You and AI agree on specs upfront
  • Native Cursor integration - /openspec-proposal, /openspec-apply, /openspec-archive
  • Everything in one place - No hunting through chat history for requirements
  • 100% free - No API keys, no MCP connectors needed
  • Universal - Works with any AI coding assistant

The Workflow That Actually Works

  1. Draft a change proposal - Capture what you want to build

  2. Review & align - Iterate until specs are solid

  3. Implement tasks - AI writes code from clear requirements

  4. Archive & update - Your specs become living docs

Why Not Just Use [Insert Other Tool]?

vs Kiro: OpenSpec keeps all related changes in one folder instead of scattering updates across multiple spec files. When you’re building a feature that touches 3 different specs, you want everything in one place, not hunting through multiple task files.

vs Chat-driven development: Your requirements stick around! They don’t disappear into chat history limbo.

vs Heavy project management tools: This is lightweight and lives right in your repo where your code lives.

Real Quick Example

# In Cursor, just type:
/openspec-proposal Add user authentication with 2FA

# AI creates the full structure:
# - proposal.md (what and why)
# - tasks.md (implementation checklist)  
# - spec deltas (what changes in your system)

# Review, iterate, then:
/openspec-apply add-user-auth

# AI implements following the agreed specs

# When done:
/openspec-archive add-user-auth

Getting Started (Literally 2 Minutes)

npm install -g @fission-ai/openspec@latest
cd your-project
openspec init
# Select "Cursor" when prompted

That’s it. Your Cursor slash commands are ready to go.

Would love to hear your experience! (Github stars :star: are always appreciated!)

Repo: GitHub - Fission-AI/OpenSpec: Spec-driven development for AI coding assistants.

Demo below ! Much love :heart:

Forgot to add here’s what the cli dashboard looks like!

It makes it super easy to see what’s in progress and what can be archived. All managed through .md files for convenience. :slight_smile: