oh-my-openspec — Claude Code and Codex plugin: what it does
oh-my-openspec — a spec-first workflow for Codex CLI and OpenCode, where an MCP gate checks the finished work against the written spec.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install oh-my-openspec@awesome-codex-pluginsWhat oh-my-openspec does
A job moves through four stages, each with its own command. $omos-init writes the spec, $omos-plan breaks it into tasks, $omos-apply carries them out, and $omos-retro closes the cycle. Seven subagents hold separate roles along the way.
Tasks coming out of the plan run in parallel. Validation is not left to the model rereading its own output: openspec_validate, an MCP gate, compares the result with the spec.
It targets Codex CLI and OpenCode; on Claude it comes from the awesome-codex-plugins marketplace under MIT. Four stages and seven roles are a lot of ceremony for a one-line fix. The shape fits work where the spec is written before the code.
What it helps with
- turn a feature request into a written spec before coding
- break a spec into tasks and run them in parallel
- check the result against the spec with a tool instead of eyeballing it
- hand work to seven role-based subagents
- close a work cycle with a retro step
Example prompts for the agent
- Run
$omos-initand draft a spec for the new feature. - Break that spec into tasks with
$omos-plan. - Execute the plan using
$omos-apply, then wrap up in$omos-retro.
How to install oh-my-openspec
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install oh-my-openspec@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about oh-my-openspec
How do I install oh-my-openspec in Claude Code?
Add the marketplace first: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Then install the plugin itself: /plugin install oh-my-openspec@awesome-codex-plugins.
What does oh-my-openspec do?
It runs a four-stage spec cycle in Codex CLI: init, plan, apply, retro, with seven subagents covering distinct roles.
What is openspec_validate for?
It is the MCP gate that checks the work against the spec mechanically, apart from the subagents.
Source text
oh-my-openspec · MIT
Spec-driven development workflow for Codex CLI and OpenCode, with planning, parallel task execution, and mechanical OpenSpec validation.
© Alexeyco · MIT · hashgraph-online/awesome-codex-plugins