# OpenSpec

> A lightweight, open-source, spec-driven framework for AI coding agents that stores functional requirements alongside your code for persistent, reviewable context.

OpenSpec is a lightweight, open-source, spec-driven framework that works universally across AI coding agents without requiring API keys or MCP. It stores functional requirements as markdown specs directly in your repository, giving agents persistent context that survives across chat sessions and team changes. By generating spec deltas alongside code changes, OpenSpec enables developers and reviewers to understand *intent*, not just implementation.

- **Spec-driven planning** — *Install via `npm install -g @fission-ai/openspec@latest` and initialize specs in your repo to start capturing functional requirements per capability.*
- **Spec deltas on every change** — *Each proposed change generates a diff of requirements, making it easy to review what the system is supposed to do before any code is written.*
- **Persistent context** — *Specs live in your codebase alongside code, organized by capability, so context never disappears when a chat session ends or a team member leaves.*
- **Proposal generation** — *Use slash commands like `/openspec:proposal` to generate a full proposal document, technical design decisions, implementation tasks, and spec deltas in seconds.*
- **Brownfield-first** — *Designed for mature codebases where understanding existing behavior is the real challenge, not just greenfield projects.*
- **Universal agent support** — *Natively integrates with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, Cline, RooCode, Amazon Q, and 20+ more coding agents.*
- **No vendor lock-in** — *No API keys, no MCP dependency; specs are plain markdown files checked into your repo and portable across any agent.*
- **Team collaboration via Git** — *Specs and change proposals are version-controlled, enabling PR-based reviews and standard Git workflows for collaboration.*
- **Coming soon: Workspaces** — *Team-focused features for large codebases, multi-repo planning, customization, and deeper integrations are in active development.*

## Features
- Spec-driven development framework
- Spec deltas for every code change
- Persistent context stored in repository
- Proposal generation with slash commands
- Implementation task breakdown
- Technical design document generation
- Universal AI coding agent support
- Brownfield codebase support
- No API keys required
- No MCP dependency
- Plain markdown spec files
- Git-based collaboration
- Custom slash commands for supported agents
- Multi-agent portability

## Integrations
Claude Code, Cursor, Codex, GitHub Copilot, OpenCode, Windsurf, Gemini CLI, Antigravity, Cline, RooCode, Kilo Code, Amazon Q, Qoder, Auggie CLI, Qwen Code, CodeBuddy, CoStrict, Crush, Factory Droid, iFlow

## Platforms
API, DEVELOPER_SDK

## Pricing
Open Source

## Links
- Website: https://openspec.dev
- Documentation: https://openspec.dev/docs
- Repository: https://github.com/Fission-AI/OpenSpec/
- EveryDev.ai: https://www.everydev.ai/tools/openspec