OpenSpec | A lightweight and configurable spec framework
CHANGELOG BLOG DOCS ↗ GITHUB ↗ / 68.0k stars MENU CHANGELOG BLOG DOCS ↗ GITHUB ↗ 68.0k stars Fission-AI / OpenSpec 68.0k GitHub stars star repository ↗
The spec framework for building the right thing and building it right FIG. 1 / DRIFT 0.045 Synopsis
OpenSpec is a lightweight and configurable framework for creating and managing software
specifications.

With OpenSpec, you capture what you want to build in a spec and keep your team and coding
agents aligned as the work evolves. We help you refine the requirements, validate that they
describe the right thing, and verify that the implementation matches.

In essence, OpenSpec helps you
build the right thing and build it right. In use 68.0k GitHub stars. A new spec every two seconds.
In use 68.0k stars on GitHub. A new spec is created with OpenSpec every two seconds. Adoption
OpenSpec helps create a new spec every two seconds, has earned
68.0k GitHub stars, and is used by more than
265,000 developers a month.
Open source, in practice Built in the open. Used in the wild. 68.0k stars on GitHub One new spec every two seconds Proof 0168.0k GitHub stars 02A new spec every two seconds Public record GitHub stars68.0k New spec intervaltwo seconds LicenseMIT OpenSpec is Starred by the community68.0k Creating a new specevery 2 seconds In the wild
OpenSpec is already part of how developers build with AI.1 A new spec is created
every two seconds.2 1 68.0k GitHub stars 2 OpenSpec usage Installation npm / pnpm / bun / yarn / nix $ npm install -g @fission-ai/openspec@latest copy Compatibility Claude CodeCodexCursorGitHub CopilotGemini CLIOpenCode Amazon Q Developer Antigravity Auggie IBM Bob Shell Cline Command Code CodeArts CodeBuddy Devin Desktop ForgeCode Continue CoStrict Crush Factory Droid Hermes Agent iFlow Junie Kilo Code Kimi Code Kiro Lingma MiniMax Code Mistral Vibe Oh My Pi Pi SourceCraft Code Assistant for VS Code Qoder Qwen Code Rovo Dev CLI Zoo Code Trae Zed Agent ZCode full directory ↗ + 33 more Workflow /opsx:explore map the problem and understand the codebase /opsx:propose draft proposal.md, specs/, design.md, tasks.md /opsx:apply implement tasks from the specification /opsx:verify check the implementation matches the spec /opsx:archive archive completed changes Links GitHub·Discord·68.0k stars·v1.13.0 © 2026 Fission
theme auto

OpenSpec is presented as a lightweight and highly configurable framework designed for the creation and management of software specifications. The fundamental objective of OpenSpec is to facilitate a process wherein teams and coding agents remain aligned as the software development work progresses. It serves to enhance the development lifecycle by enabling users to refine requirements, validate that these requirements accurately describe the intended outcome, and verify that the subsequent implementation faithfully matches the established specifications, thus aiming to help users build the right thing and build it right.

The framework operates on the principle of capturing desired outcomes within a formal specification to maintain coherence throughout the development process. This capability is supported by significant community traction, evidenced by a substantial number of GitHub stars, totaling sixty-eight thousand, alongside a rapid iteration cycle where a new specification is created every two seconds, demonstrating active community engagement and continuous development. This adoption is further reflected in its usage, as OpenSpec is utilized by more than two hundred sixty-five thousand developers monthly. The project emphasizes an open source philosophy, being built and used openly within the development community.

The framework is integrated into the current landscape of software development, particularly in contexts involving artificial intelligence. OpenSpec’s utility extends to guiding how developers interact with various AI-powered tools, acting as a standardized mechanism for defining and enforcing requirements that these agents must adhere to. Installation is facilitated through standard package managers such as npm, pnpm, bun, yarn, and nix. Furthermore, OpenSpec demonstrates broad compatibility with a wide array of development and AI tools, including Claude, Codex, Cursor, GitHub Copilot, Gemini, and various command-line and agent-based systems, underscoring its cross-platform applicability.

The framework establishes a defined workflow for managing specifications. This workflow is structured through specific operational commands designed to guide the user from problem understanding to implementation validation. The workflow involves exploratory steps such as mapping the problem and understanding the existing codebase, proposing a draft proposal, and subsequently applying the necessary tasks derived from the specification. Crucially, the process includes a verification step to check if the implementation successfully aligns with the original specification, culminating in an archiving step for completed changes, thereby ensuring traceability and accountability throughout the development lifecycle.