oh-my-codexとは？OSSで注目されるCodex CLIオーケストレーション層を解説

本記事について: 本記事はGitHub上の公式ドキュメント（README）・公式サイト・npmパッケージページを参照して執筆しています。実際にインストール・実行した体験に基づくものではなく、ドキュメントベースの解説です。

OpenAI Codex CLIをより強力に使いたいと思ったことはないでしょうか。マルチエージェント実行・フック・永続状態管理といった機能をCodexに追加できるOSSが「oh-my-codex（OMX）」です。2026年4月時点で約24,000スターを獲得しており、Codex CLIの実践的なオーケストレーション層として注目を集めています。

本記事では、oh-my-codexの概要・主要機能・推奨ワークフロー・類似ツールとの比較を解説します。Codex CLIをすでに使っているエンジニアがOMXの導入を検討する際の判断材料になれば幸いです。

執筆者

秋霜堂株式会社 代表 石川瑞起

中学生でプログラミングを独学で習得し、HP制作やアプリ開発の事業を開始。 大学入学後に事業を売却し、トヨクモ株式会社へ入社。 3年間にわたり1製品の開発責任者を務めたのち秋霜堂株式会社を設立し、多数の企業をサポートしている。

oh-my-codex（OMX）とは

oh-my-codex（公式略称: OMX、OmX）は、OpenAI Codex CLI の上に構築されたオープンソースのオーケストレーション/ワークフロー層です。

公式READMEでは次のように説明されています。

"OmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more."

— Yeachan-Heo/oh-my-codex README

名前が示す通り、oh-my-zshとの類比でイメージするとわかりやすいです。oh-my-zshがzshシェルにプラグイン・テーマ・ユーティリティを追加するように、oh-my-codexはCodex CLIにスキル・エージェントチーム・フック・永続状態管理を追加します。

リポジトリ基本情報

MITライセンスでの提供のため、商用利用を含めて自由に使用できます。

なぜ oh-my-codex が注目されるのか

Codex CLIは、ターミナルで動作する軽量なAIコーディングエージェントです。一方で、単体では以下の点が弱いとされています。

• マルチエージェントの連携: 複数エージェントを並列実行・調整する仕組みがない
• フック機能: セッション開始・ツール使用前後などのイベントに処理を挟む手段が限定的
• 永続状態管理: セッション間でのプロジェクト状態・計画・ログを保持するための統一した仕組みがない

oh-my-codexはCodex CLIを置き換えるのではなく、これらの不足を補う「上位層」として動作します。Codexが推論・コード生成を担い、OMXがワークフロー・オーケストレーションを担うという役割分担です。

公式READMEには「plain Codexを望むなら不要」とも明記されており、Codex単体で十分なユースケースに無理に導入する必要はありません。すでにCodexを活用しており、より複雑なワークフローや大規模なタスクを扱いたいエンジニアに向けたツールです。

oh-my-codex の主要コンセプトと機能

4つのコアスキル

oh-my-codexの中心となるのが、4つのコアスキル（ワークフローコマンド）です。公式READMEの推奨ワークフローに沿って、それぞれの役割を説明します。

$deep-interview — 要件の明確化

タスクの意図・境界・非目標を明確にするためのスキルです。実装に入る前に、何を作るべきかを整理する工程に使います。

$ralplan — 計画の承認とトレードオフ検討

実装計画を作成し、採用するアプローチのトレードオフを検討するスキルです。設計の段階でリスクや代替案を整理します。

$ralph — 永続的な完了ループ

承認された計画を完了まで粘り強く実行するスキルです。検証ループを持ち、タスクが完了するまで継続します。

$team — 並列チーム実行

大規模なタスクを複数ワーカーが並列実行するスキルです。tmux（macOS/Linux）またはpsmux（Windows）を使用して複数プロセスを調整します。

3:executor の部分でワーカー数（3）と役割タイプ（executor）を指定します。

.omx/ ディレクトリと状態管理

oh-my-codexは .omx/ というディレクトリにプロジェクトの状態を永続化します。格納されるのは以下のようなデータです。

• プロジェクトガイダンス（AGENTS.md）: スコープ付きのプロジェクト指示
• プラン（plans/）: 承認された実装計画
• ログ（logs/）: セッションのログ
• メモリ（memory/）: セッション間で引き継ぐ情報
• wiki（.omx/wiki/）: ローカルマークダウンwiki
• フック（.omx/hooks/*.mjs）: OMXプラグインフック

セッションをまたいでもプロジェクト状態が失われないため、長期にわたるタスクや複数人での作業に適しています。

フック機構

oh-my-codexはCodexのネイティブフックとOMX固有のプラグインフックを組み合わせた2層構造を持ちます。

• ネイティブ Codex フック (.codex/hooks.json): Codex CLIのフック登録。SessionStart、PreToolUse、PostToolUse などのイベント処理
• OMX プラグインフック (.omx/hooks/*.mjs): OMX 独自のプラグインフック

この仕組みにより、ツール実行の前後に独自の処理を挟み込んだり、セッション開始時の初期化処理を自動化したりできます。

推奨ワークフロー

公式READMEでは、以下の3ステップが推奨ワークフローとして示されています。

（出典: Yeachan-Heo/oh-my-codex README.md）

実際のセッション起動は以下のコマンドを使います。

（出典: Yeachan-Heo/oh-my-codex README.md）

また、モニタリングにはHUDが利用できます。

（出典: Yeachan-Heo/oh-my-codex README.md）

前提条件と導入の注意点

oh-my-codexを導入するには、以下の環境が必要です。

特に Codex CLIの認証設定が前提となる点に注意が必要です。oh-my-codexはCodex CLIの上に構築されているため、Codexが動作しない環境ではOMXも動作しません。

また、公式READMEには「plain Codexを望むなら不要」という記述があります。Codex CLIを単発タスクに使う程度であれば、OMXを導入する必要はありません。以下のようなケースで特に価値を発揮します。

• 複数の並列エージェントを使った大規模タスクを実行したい
• セッション間でプロジェクト状態を維持したい
• フックを使ってセッション開始・ツール使用前後に独自処理を挟みたい
• 大型機能開発の要件整理から実装完了までのワークフローを標準化したい

類似プロジェクトとの比較

openai/codex（ベース）との比較

oh-my-claudecode との比較

同じ作者（Yeachan-Heo）が作成した、Claude Code向けの類似ツールが oh-my-claudecode です。

どちらを選ぶかは、使用しているAIエージェント（Codex か Claude Code か）によって決まります。

まとめ：初見エンジニアへのガイド

oh-my-codex（OMX）は、OpenAI Codex CLIをより体系的に活用したいエンジニア向けのオーケストレーション層です。

以下のようなエンジニアに特に有用です。

• Codex CLIをすでに使っており、マルチエージェント実行を試したい: $team スキルで並列ワーカーを立ち上げ、大規模タスクを分散実行できます
• 長期プロジェクトでCodexを活用したい: .omx/ ディレクトリによる永続状態管理で、セッションをまたいだ継続作業が可能になります
• 要件整理→計画→実行のフローを標準化したい: $deep-interview → $ralplan → $ralph/$team の推奨ワークフローが指針になります

一方、Codex CLIを単発タスクに使う程度であれば、OMXを導入せずCodex単体で十分な場合もあります。公式READMEの「plain Codexを望むなら不要」という言葉が示す通り、自分のユースケースに合わせて判断してください。

詳しくは公式ドキュメントを参照してください。

• GitHub リポジトリ: https://github.com/Yeachan-Heo/oh-my-codex
• 公式サイト: https://yeachan-heo.github.io/oh-my-codex-website/
• npm パッケージ: https://www.npmjs.com/package/oh-my-codex