# Oh My Codex（OMX）とは？OpenAI Codex CLIをマルチエージェントコーディングチームに変えるオーケストレーション層

Oh My Codex（OMX）はOpenAI Codex CLI向けのオープンソースワークフロー層です。マルチエージェントチーム、tmuxオーケストレーション、永続メモリ、フック、$teamやautopilotなどの構造化ワークフローを追加する方法を学びます。

Canonical URL: https://a2a-mcp.org/blog/what-is-oh-my-codex-ja

Language: ja

Published: 2026-04-07

Updated: 2026-04-07

## 主なポイント

- **Oh My Codex (OMX)** は、公式の OpenAI Codex CLI の上に構築されたオープンソースのオーケストレーションレイヤーであり、コアの Codex 実行エンジンを置き換えることなく、マルチエージェントの連携、永続的な状態管理、フック機能、構造化されたワークフローを追加します。
- プロジェクトアーキテクチャの分析によると、OMX は **Codex における oh-my-zsh のような役割**を果たします：再利用可能なスキル（$deep-interview, $ralplan, $ralph, $team）、33種類の専門化されたエージェントプロンプト、tmuxベースの並列ワーカーを提供し、実際の推論とコード生成は Codex が処理します。
- GitHub と Discord でのコミュニティフィードバックから、OMX は分離された git worktree を通じて安全な並列開発を可能にし、`.omx/` ディレクトリとレジリエントなノートパッドメモリを活用して、複雑なプロジェクトにおけるコンテキストの喪失を削減することが示されています。
- インストールとセットアップは `npm install -g oh-my-codex` の後に `omx setup` を実行するだけで 2 分未満で完了します。macOS/Linux では tmux、Windows では psmux をサポートします。
- 高度な機能には、自律的なリサーチ、オートパイロットモード、OpenClaw 通知連携、タスクの複雑さに基づいたモデルルーティングが含まれ、大規模なリファクタリング、フルスタック構築、チームスタイルの AI 開発に最適です。

## Oh My Codex とは？

Oh My Codex（略称 **OMX**）は、[OpenAI Codex CLI](https://github.com/openai/codex) 専用のワークフローおよびオーケストレーションレイヤーとして機能します。主に Yeachan Heo によって開発され、HaD0Yun などのメンテナーからの貢献もあり、基盤となる Codex CLI の主要な制限（ネイティブなマルチエージェントサポート、フック機能、セッションの永続性、高度なランタイムツールの欠如など）に対応しながら、Codex を主要な実行エンジンとして維持します。

プロジェクトのドキュメントと v0.10.0 のリリースノートによると、OMX 自体は Codex をフォークまたは変更していません。代わりに、強化されたプロンプト、スキル、状態管理、tmux 駆動の並列処理でセッションをラップします。メンタルモデルは単純です：Codex はエージェント的なコーディングタスクを実行し、OMX はタスクのルーティング、チーム連携、および開発者エクスペリエンスを担当します。

実際のデモやユーザーレポートからのベンチマークによると、OMX は、計画、実行、検証をそれぞれ専門とするエージェントの「チーム」を連携させることで、複雑なワークフローを加速させます。これにより、複数ファイルの変更やアーキテクチャレベルの決定におけるエラーを減少させています。

## Oh My Codex の主要機能

OMX は、いくつかの緊密に連携したシステムを通じて、本番環境レベルの拡張機能を提供します：

- **tmux によるマルチエージェントオーケストレーション**: `.omx/team/<name>/worktrees/worker-N` の隔離された git ワークツリーで並列ワーカーを生成します。これにより、同時編集時の書き込み衝突を防止します。
- **構造化されたスキルとキーワード**: 意図を明確にするための `$deep-interview`、トレードオフレビューを含む合意形成計画のための `$ralplan`、検証されるまで永続的な「ボルダー（重要課題）」実行のための `$ralph`、並列チームのための `$team N:executor` など、組み込みのコマンドを備えています。
- **永続的状態とメモリ**: `.omx/` ディレクトリには、計画、ログ、プロジェクトメモリ（`.omx/project-memory.json`）、およびコンテキスト剪定後も維持される優先順位付きのノートシステムが保存されます。
- **フックと HUD**: 拡張可能なフック（`.omx/hooks/*.mjs` および Codex ネイティブの `.codex/hooks.json`）に加え、リアルタイムモニタリングのためのライブヘッドアップディスプレイ（`omx hud --watch`）を提供します。
- **33 の専門化されたエージェントプロンプト**: ビルド/分析、レビュー、ドメイン、調整の各レーンに分類されており、`AGENTS.md` を通じて自動的に読み込まれます。
- **自律的および高度なモード**: エンドツーエンド実行のためのオートパイロット、自律的な調査（`omx autoresearch`）、最大並列処理のためのウルトラワーク、複雑度に応じたインテリジェントなモデルルーティング。

これらの機能により、曖昧なプロンプトが信頼性の高い多段階の成果物に変換されます。

## Oh My Codex の仕組み：技術的詳細

OMX は、`omx` で起動すると強化された Codex セッションを初期化します。正規のプロンプトを注入し、スキルをインストールし、委任ルールのための `AGENTS.md` を生成し、状態、メモリ、コードインテリジェンス（LSP ツール、AST grep）、およびチームオーケストレーションのための MCP サーバーを設定します。

**コアワークフローパイプライン**（公式デモに示されている通り）：

1. **意図の分類と深層インタビュー** — 実行前に曖昧さを軽減します。
2. **計画と承認** — アーキテクチャの合意形成に `$ralplan` を使用します。
3. **チーム実行** — 隔離されたワークツリーを持つ tmux ペインを生成し、ワーカーは完了を報告する前に変更をコミットします。
4. **検証とマージ** — リーダーは、`--no-ff -X theirs` やチェリーピックなどの戦略を使って変更を段階的にマージし、衝突は自動的にログに記録されます。

**チームコマンドの例**：

```bash
omx team 3:executor "parallelize auth migration across modules"
```

このシステムには、クレームセーフなタスクライフサイクル、ワーカー間のメールボックスメッセージング、およびセッション中断後も維持される耐久性のある状態が含まれています。

**高度なヒント**: 主な焦点は Codex ネイティブにありますが、（互換性のある設定では）`OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude` を使用して、複数のプロバイダーを混在させたチームを構成することもできます。

## Oh My Codex vs. Base Codex CLI とその他のツール

| 特徴                   | OpenAI Codex CLI (基本版)       | Oh My Codex (OMX)                          | Cursor / Claude Code                 |
|------------------------|----------------------------------|--------------------------------------------|--------------------------------------|
| **実行エンジン**       | 単一エージェント                 | 複数のCodexエージェント+スキルをオーケストレーション| エディタファーストまたは単一エージェント中心 |
| **マルチエージェント対応**| なし                           | ネイティブtmuxチーム + ワークツリー分離    | 限定的または発展途上                 |
| **永続的状態**         | セッション限り                   | `.omx/` ディレクトリ + ノートパッドメモリ   | プロジェクトコンテキストのみ         |
| **フック & 拡張性**    | 基本的                          | 完全なカスタムフック + OpenClaw統合        | 拡張機能/プラグイン                  |
| **ワークフロー**       | 手動プロンプト入力               | プリビルト: オートパイロット, $ralph, $team| GUI駆動                             |
| **安全性 & 監視**      | なし                             | セーフティフック + ライブHUD               | さまざま                            |

OMXは、オーケストレーションと並行性が最も重要となる、CLIファーストの大規模エンジニアリングで優れています。

## インストール、セットアップ、およびよくある落とし穴

**クイックスタート** (2分以内):

```bash
npm install -g @openai/codex oh-my-codex
omx setup
omx doctor
omx --madmax --high
```

**よくある落とし穴** とその回避方法:

- **`omx setup`を忘れる** — プロンプト/スキルインストールと `AGENTS.md` 生成をスキップし、弱いセッションにつながる。
- **Intel Macでの高CPU使用率** — Gatekeeperが原因; `xattr -dr com.apple.quarantine $(which omx)` と低い並行性フラグで軽減。
- **クリーンワークスペースなしのチームモード** — リーダーは開始前にスタッシュ/コミットする必要がある。そうしないとワークツリーが失敗する。
- **ワーカーコミットプロトコルの無視** — エージェントは `git add -A && git commit` するか、またはランタイム自動コミットをフォールバックとして使用する。
-
 **デフォルトで無効化されているフック** — `OMX_HOOK_PLUGINS=1` で有効にしてプロダクション安全性を確保。

**高度なヒント**: 読み取り専用リポジトリ分析には `omx explore --prompt "..."` を、委任前の安全なシェル検査には `omx sparkshell` を実行してください。

## エッジケースと高度なユースケース

-l **大規模リファクタリング**: TypeScriptコードベース全体をOMXに投入し、調整されたエージェントによるクリーンなPython書き換えを実現。
- **長時間実行プロジェクト**: 永続的な `.omx/state/` とノートパッドにより、数日間にわたるセッション再開が可能。
-V **プロダクション統合**: OpenClawフックがセッションイベント、アイドル状態、またはユーザー質問の通知を送信。
- **カスタム拡張**: プラグインシステム経由でスキルを追加したり、Python REPLデータ分析のためのMCPツールを拡張したり。

これらの機能は、自律的なリサーチ、完全なアプリケーションのブートストラップ、または詳細なインタビュー形式の明確化を必要とする実験において、OMXを特に強力にします。

## 結論

Oh My Codex は、強力な単一エージェントを連携し状態を保持するチームに変えることで、CLI ベースの AI コーディングを次の段階へと進化させます。そのアーキテクチャと実世界での使用を分析すると、複雑な開発タスクにおいて信頼性、速度、安全性において測定可能な向上をもたらしていることがわかります。

あなたの Codex ワークフローをアップグレードする準備はできていますか？ 今日 `npm install -g oh-my-codex && omx setup` を実行し、次の曖昧な要件に対して `$deep-interview` から始めましょう。公式リポジトリとドキュメントは、大規模なオーケストレーションを始めるために必要なすべてを提供しています。