oh-my-codex (scalarian) — Summary

oh-my-codex v2 by scalarian is a now-archived (April 2026) fork of the OMX naming pattern, self-described as "not the old Codex-to-Claude bridge" but "a full Codex product" with a CLI, MCP families, agent catalog, plugin SDK, and tmux-aware team execution. With 65 stars and archived status, it represents a brief parallel effort that was active for approximately 3 months before being abandoned. The framework ships 14 skills, an omx binary built from a TypeScript monorepo (packages/cli, packages/core, packages/mcp-server), 5 hook handlers (SessionStart, PreToolUse, PostToolUse, UserPromptSubmit, Stop), and durable state under .omx/ mirroring the Yeachan canonical layout. The skills are notably more focused than the canonical project: architect, autoresearch, deep-interview, doctor, executor, hud, plan, research, review, reviewer, tdd, team, trace, ultrawork. Closest seed comparison: resembles superpowers in its skills-only behavioral framework but adds a CLI runtime and MCP servers; it is structurally derivative of the Yeachan canonical project with fewer components and no active maintenance.

oh-my-codex (scalarian) — Overview

Origin

Created by scalarian (@scalarian). Active from roughly January-April 2026; archived April 1, 2026. Appears to be an independent implementation of OMX v2 concepts that diverged from the canonical Yeachan project and was later abandoned. The README explicitly says "OMX v2 is not the old Codex-to-Claude bridge."

Note: The scalarian README references local paths like /Users/staticpayload/Mainframe/oh-my-codex/ suggesting it was developed by user "staticpayload" (not "scalarian") — the GitHub user and local path are inconsistent.

Philosophy

From README:

"OMX v2 is not the old Codex-to-Claude bridge. It is a full Codex product built around: durable .omx/ state, tmux-aware team execution, a real agent catalog, a plugin SDK plus Codex plugin bridge, a first-party hook pack for Codex hooks, CLI, MCP, docs, demos, and packaged assets in one repo."

"Codex is the first-party executor in v2. There is no Claude bridge in this release."

Key Differentiator from Yeachan

• Codex-only: no Claude CLI worker support (unlike Yeachan which added Claude worker CLI)
• Monorepo structure: packages/cli, packages/core, packages/mcp-server in separate packages
• Slimmer skill set: 14 skills vs 46 in the canonical project
• Archived: maintenance stopped April 2026

MCP Families (from README)

• omx_task_* — task management
• omx_state_* — state management
• omx_memory_* — memory
• omx_note_* — notes
• omx_explore_* — exploration
• omx_team_* — team lifecycle
• omx_plugin_* — plugin management
• omx_hook_* — hook status
• omx_agent_* — agent catalog

oh-my-codex (scalarian) — Architecture

Distribution

• npm package (workspace, no binary in root package.json — binary lives in packages/cli)
• Binary: omx (from packages/cli/dist/bin.js)
• Status: archived as of April 1, 2026

Install

From README:

Install this to .codex - https://github.com/staticpayload/oh-my-codex/

Fallback:

npm install
npm run build
cd packages/cli && npm link
node packages/cli/dist/bin.js setup apply

Required Runtime

• Node.js (version unspecified; assumed >= 18)
• Codex CLI
• tmux (for team mode)

Directory Tree

oh-my-codex/
├── packages/
│   ├── cli/            — omx binary (dist/bin.js)
│   ├── core/           — core runtime logic
│   └── mcp-server/     — MCP server implementations
├── crates/             — Rust (mirrored from Yeachan)
│   └── omx-explore/
├── plugins/
│   └── omx-product/    — Codex plugin bundle
├── hooks/
│   └── handlers/
│       ├── post-tool-use.mjs
│       ├── pre-tool-use.mjs
│       ├── session-start.mjs
│       ├── stop.mjs
│       └── user-prompt-submit.mjs
├── skills/             — 14 SKILL.md files
├── templates/
│   └── agents/
├── .agents/            — plugin marketplace metadata
└── demos/

Target AI Tools

• Primary: OpenAI Codex CLI only
• No Claude CLI worker support in v2

State Root

.omx/ in the project directory (same schema as Yeachan canonical):

• .omx/hud-config.json
• .omx/logs/
• .omx/memory/
• .omx/plans/
• .omx/research/
• .omx/sessions/
• .omx/state/
• .omx/team/

oh-my-codex (scalarian) — Components

CLI Binary: omx (packages/cli)

Subcommands listed in README:

• omx setup / omx setup --force / omx setup --dry-run / omx setup repair / omx setup uninstall / omx setup migrate-v1
• omx doctor / omx hud
• omx team init / omx team spawn executor / omx team queue / omx team claim / omx team complete / omx team review / omx team inbox / omx team logs / omx team shutdown
• omx plugins validate / omx plugins pack / omx plugins install-local / omx plugins doctor
• omx hooks install --presets=workspace-context,memory,safety,review / omx hooks status / omx hooks explain
• omx explore index / omx explore refs / omx explore rename-preview / omx explore diagnostics
• omx autoresearch init / omx session start / omx agents list|show|install|validate
• omx version

Skills (14 total)

Hooks (5 handlers)

Hook presets: memory, safety, review, telemetry, workspace-context

Agent Personas (templates/agents/)

architect, planner, researcher, executor, reviewer, operator (from README)

MCP Families (packages/mcp-server)

• omx_task_*, omx_state_*, omx_memory_*, omx_note_*, omx_explore_*, omx_team_*, omx_plugin_*, omx_hook_*, omx_agent_*

Plugin SDK

• omx plugins init|pack|validate|install-local|list|enable|disable|doctor
• Plugin schema: .codex-plugin/plugin.json
• Marketplace bundle: plugins/omx-product/

oh-my-codex (scalarian) — Uniqueness

Differs From Seeds

Most similar to oh-my-codex-yeachan (canonical), from which it derives its architecture, state layout, and skill naming vocabulary. Within the seeds, closest to superpowers (skills-based behavioral framework) but adding a CLI runtime — however it lacks superpowers' comprehensive Iron Law prompting and TDD enforcement. Differs from agent-os in having a runtime binary and MCP servers. Differs from BMAD-METHOD in lacking persona-based role switching. The key distinction from the canonical oh-my-codex is its explicit Codex-only positioning ("no Claude bridge in v2"), reduced skill count (14 vs 46), monorepo architecture, and archived status.

Positioning

• Derivative of oh-my-codex-yeachan; not the canonical package
• More focused surface area (14 skills vs 46) — potentially easier to audit
• Codex-only design choice removes the Claude-worker complexity
• Archived April 2026 — no longer maintained

Note on Identity

The local paths in the README (/Users/staticpayload/Mainframe/oh-my-codex/) suggest the developer's GitHub handle is "staticpayload" but the repo is hosted under "scalarian" — likely a different account or fork transfer.

Observable Failure Modes

• Archived: no bug fixes or updates
• Local path leakage in README suggests the README was committed directly from dev machine without sanitization
• Missing the ultragoal durable ledger that Yeachan added — cross-session handoff is weaker
• No quantitative ambiguity scoring in deep-interview — interview quality is less rigorous

Canonical Status

Not canonical. The oh-my-codex npm package is owned by Yeachan-Heo's repo.