OpenSpec Spec Generator minimal version
GitHub
AI coding agents · Spec-driven development

OpenSpec: a lightweight open spec layer for AI coding agents

Write down what you want as a spec before any code is touched. Your agent implements against that spec, and you verify that the implementation matches the spec.
No spec means the agent guesses. With a spec, every change is traceable.

Per the official site openspec.cn: 68.7k GitHub stars, MIT license, currently v1.13.0, with a new spec created roughly every 2 seconds. Works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode and more.

Generate your first open spec in 30 seconds

Fill in two fields and get four OpenSpec files you can paste straight into your project. This is a scaffold generator — it calls no AI and uploads nothing; everything runs in your browser. Hand the output to your agent with /opsx:apply.

Produces 4 files + the command order

Why put a spec layer above the code

Agents can't read your mind

If you don't write down what you want, the agent guesses. Wrong guesses mean churned code and manual rollbacks.

You can't tell what changed afterwards

An open spec keeps the "why we built it this way" record, so the code still makes sense three months later.

You can verify the result

The last step of the OpenSpec workflow is /opsx:verify, which checks the implementation against the spec — not just whether tests pass.

The five-step OpenSpec workflow

  1. /opsx:explore — understand the problem and the existing code before writing anything
  2. /opsx:propose — draft proposal.md, specs/, design.md and tasks.md
  3. /opsx:apply — let the agent implement the tasks
  4. /opsx:verify — check that the implementation matches the spec
  5. /opsx:archive — archive the finished change

Install it

npm install -g @fission-ai/openspec@latest
Claude Code Codex Cursor GitHub Copilot Gemini CLI OpenCode + more

FAQ

What is OpenSpec?

OpenSpec is a lightweight, configurable open spec framework for AI coding agents. It adds a spec layer above your code: you describe what should change first, the agent implements against that description, and you verify the result before archiving the change.

Is "open spec" the same thing as OpenSpec?

People search for both spellings. "Open spec" describes the idea — a specification kept in the open, next to the code, that both humans and agents can read. OpenSpec is the open-source tool that implements that idea, maintained by Fission-AI under the MIT license.

Which AI coding agents does OpenSpec work with?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode are supported, plus more — the official site openspec.cn lists the full set.

Does this page send my input anywhere?

No. The generator runs entirely in your browser. It calls no AI model and uploads nothing — it only fills in a text template you can copy or download.

Do I need to install anything to use this generator?

No, this page works on its own. You only install OpenSpec itself if you want to run the full workflow in your own project: npm install -g @fission-ai/openspec@latest.