hashgraph-online/awesome-codex-plugins / plugins/alexeyco/oh-my-openspec/skills/omos-setup
omos-setup
UnverifiedInstall the oh-my-openspec Codex host pieces: the seven ~/.codex/agents/omos-*.toml role agents via the bundled installer, then the openspec MCP-server approval. Invoke via $oh-my-openspec:omos-setup.
omos-setup
Install this plugin's Codex host pieces once per machine: the seven role
agent TOMLs under ~/.codex/agents/, then the openspec MCP-server
approval. Run it after codex plugin add oh-my-openspec@oh-my-openspec,
or any time spawn_agent reports an unknown omos-* agent. This skill
acts directly — it dispatches no roles. You never run git write
commands.
Flow
1. Check current state
List ~/.codex/agents/omos-*.toml. The seven expected roles:
omos-critic, omos-implementer, omos-planner, omos-researcher,
omos-retrospector, omos-reviewer, omos-verifier.
- All seven present and unchanged → already installed; say so and go to §4 only if the approval is still missing.
- Any missing → continue with §2.
- Any differing → continue with §2. The installer plans each file as
copy, skip, update, or conflict: a differing file that carries the
# managed-by:marker is our own and updates silently; a foreign differing file is refused — replacing it is the user's explicit--forcechoice.
2. Locate the marketplace root
Run codex plugin marketplace list and read the oh-my-openspec
entry's local source path — the on-disk clone of this repository. That
clone is <root> for §3.
3. Run the installer
Run node <root>/plugins/oh-my-openspec/assets/install-agents.mjs.
- It copies the seven TOMLs into
~/.codex/agents/(created when missing), skips byte-identical files — a second run reports seven skips, zero copies — and refuses per file to clobber a differing target unless the user passed--force. - It prints the §4 approval and restart steps itself.
- Node ≥ 22.18 is required (the bundled MCP server imports
.ts); the installer warns below that floor.
Alternative for users who prefer a fresh clone — read-only, no plugin install needed:
git clone https://github.com/alexeyco/oh-my-openspec /tmp/oh-my-openspec &&
node /tmp/oh-my-openspec/plugins/oh-my-openspec/assets/install-agents.mjs
4. Approval and restart
- Approve the
openspecMCP server when Codex prompts — it providesopenspec_validateasmcp__openspec__openspec_validate. - Restart the session so the agents and the MCP server load.
5. Verify
- Re-run the §1 check: exactly seven
~/.codex/agents/omos-*.toml, byte-identical to the installer's sources. - Ask the user to confirm, in a fresh session, that
spawn_agentcan name the roles andmcp__openspec__openspec_validateanswers.
Guardrails
- Never write
~/.codex/config.toml—codex plugin addowns plugin enablement. - Never overwrite a FOREIGN differing
~/.codex/agents/omos-*.toml— files without the# managed-by:marker need the user's explicit--forcechoice; marker-carrying files are ours and update silently. - Never commit, push, or stage anything.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |