OpenAI Codexを最強のAI開発パートナーに進化させるワークフロー拡張ツール — oh-my-codex

アーキテクチャ・仕組み

• OMXはOpenAI Codex CLIの上に被せるワークフローレイヤーであり、Codex自体を置き換えるものではない
• Codexが実際のエージェント作業（コード生成・実行）を担当し、OMXはタスクのルーティング・ワークフロー管理・ランタイム支援を担当
• プロジェクトの計画・ログ・メモリ・モード状態は.omx/ディレクトリに永続化される
• AGENTS.mdによるスコープ付きプロジェクトガイダンスを提供

主要なスキル（コマンド）一覧

チームランタイム

• omx team N:role "タスク" で複数エージェントを並列起動
• omx team status/resume/shutdown <team-name> でチーム管理
• tmux（macOS/Linux）またはpsmux（Windows）によるdurableなワークツリー連携

追加のオペレーター機能

• omx doctor — インストール状態の診断
• omx hud --watch — 監視・ステータス表示用HUD
• omx explore --prompt "..." — リポジトリの読み取り専用探索
• omx sparkshell <command> — シェルネイティブの検査・限定検証

対応環境

• Node.js: 20以上
• OS: macOS、Linux（Ubuntu/Debian/Fedora/Arch）、Windows（psmuxまたはWSL2経由）
• 依存: OpenAI Codex CLIがインストール・認証済みであること

チームモードのプラットフォーム別セットアップ

既知の問題

• Intel Macで--madmax --high起動時にsyspolicyd/trustdのCPU使用率が急上昇する場合がある
• 対処法: xattr -dr com.apple.quarantine $(which omx) の実行、またはターミナルを開発者ツール許可リストに追加

多言語対応

READMEは英語・韓国語・日本語・簡体字中国語・繁体字中国語・ベトナム語・スペイン語・ポルトガル語・ロシア語・トルコ語・ドイツ語・フランス語・イタリア語・ギリシャ語・ポーランド語の15言語に対応

ライセンス

MITライセンス（商用利用含め自由に利用可能）

インストール手順

1. Node.js 20以上が必要です
2. Codex CLIとOMXをグローバルインストール:

npm install -g @openai/codex oh-my-codex

1. 初期セットアップ:

omx setup

1. 推奨設定で起動:

omx --madmax --high

1. セッション内で以下のコマンドを使って作業開始:

$deep-interview "要件を明確にする"
$ralplan "実装計画を承認する"
$ralph "計画を完了まで進める"
$team 3:executor "並列で実行する"

※ チームモードを使う場合、macOS/Linuxではtmux、Windowsではpsmuxが必要です。