Yeachan-Heo/oh-my-codex

oh‑my‑codex (OMX) – OpenAI Codex 用のワークフロー層

何であるか – OMX は公式 OpenAI Codex コマンドラインツールの上に軽量な CLI ラッパーとして機能します。Codex のコード生成エンジンを置き換えるものではありません。代わりに、構造的で明確なワークフロー、永続的なプロジェクト状態、および繰り返し使える「スキル」（コマンド）を追加し、日常的なプロンプト操作をより再現可能にします。

なぜ存在するか – Codex を使用する多くの開発者は、同じ手順を繰り返す必要があると報告しています：タスクの明確化 → プランの取得 → 承認 → プランの実行。OMX はこのパターンを $deep‑interview → $ralplan → $ultragoal（オプションでより厳格なバージョン）として定式化し、中間成果物を隠しフォルダ .omx/ に保存します。これにより、以下の利点が得られます：

• 単一のエントリポイント（omx）：適切なモデル設定（高負荷推論、オプションの「madmax」サンドボックス回避）で Codex セッションを起動。
• プロジェクトスコープのガイダンス：AGENTS.md ファイルをマージまたは分離可能。
• 永続的なログ、プラン、チェックポイント：長時間のリファクタリングを再開または監査可能。
• macOS/Linux 用の tmux ベース UI：ターミナルを HUD と Codex パネルに分割し、マルチパネル操作をスムーズに。

入手方法

# 既に Codex CLI を持っている場合
npm install -g oh‑my‑codex
# そうでない場合はまず Codex をインストール
npm install -g @openai/codex
npm install -g oh‑my‑codex

インストール後、一度限りのセットアップを実行します：

omx setup --scope project --merge-agents   # 管理したいリポジトリ内で実行
# または
omx setup --scope user                     # グローバルなユーザー設定用

正常に動作するか確認します：

omx doctor                     # 依存関係と実行時ファイルのチェック
omx exec -C . "Reply with exactly OMX‑EXEC‑OK"   # 実際の Codex 呼び出しのスモークテスト

通常のワークフロー

1. セッションの開始（隔離のために git worktree を推奨）：

   omx --worktree=feat/task --madmax --xhigh
   

2. 明確化 – $deep‑interview "…" – Codex に追加質問を行い、問題定義を洗練させる。
3. 計画 – $ralplan "…" – 具体的なアーキテクチャ/実装計画を取得し、承認する。
4. 実行 – 実行スパインのいずれか：
   • $ultragoal / $ultrawork – 永続的でチェックポイント付きの実行、.omx/ultragoal にレジャーを保存。
   • $autopilot – 明確化から実行までを完全に監視されたループ。
   • $ralph – 単一所有者ループで簡単なタスクに適している。
   • $prometheus‑strict – 高リスク変更には追加の批判ステップを追加。
5. オプションのリサーチ – $best‑practice‑research、$autoresearch、$autoresearch‑goal で計画前に外部証拠を取得。

キーワードとコマンド

概念	意味	代表的なコマンド
Worktree	実行のルートとして使用される隔離された git チェックアウト。	omx --worktree=feature/auth …
MADMAX	--dangerously-bypass-approvals-and-sandbox のショートカット；Codex のセーフティガードを無効化（信頼できるリポジトリでのみ使用）。
モデルの努力	--high / --xhigh で model_reasoning_effort を設定し、Codex により多くの計算を要求。
AGENTS.md	永続的なガイダンスファイル（グローバルまたはプロジェクトスコープ）で、役割、セーフティルール、ルーティングを定義。
.omx/	プラン、ログ、メモリスナップショット、レジャー ファイルが保存されるディレクトリ。
スキル	組み込みのコマンドショートカット（$deep‑interview、$ralplan、$ultragoal など）で、特定の Codex プロンプトを呼び出す。
チームモード	omx team で tmux 管理のマルチパネルセッションを起動し、並列作業可能。
直接モード	omx --direct で tmux UI を使わず Codex を実行。既存のターミナル内で有用。

対象ユーザー

• すでに OpenAI Codex CLI に慣れているが、再現可能で状態保持可能なワークフローを望む開発者。
• AGENTS.md を通じて プロジェクトレベルのガイダンス を必要とし、計画と実行のチェックポイントを記録したいチーム。
• macOS/Linux ユーザー（デフォルトで完全にサポートされるパス）。Windows サポートは存在するが、安定性は低い。

制限事項 / 注意点

• 主に macOS/Linux 向けに最適化されている。Windows では動作しない、または不安定になる可能性がある。
• 「madmax」フラグはセーフティチェックを無効化するため、信頼できるコードベースでのみ使用すること。
• OMX は動作する認証済みの codex バイナリに依存しており、認証自体は管理しない。
• 起動時に更新をチェックする。OMX_AUTO_UPDATE で無効化または延期可能。

プロジェクトの健全性

• npm に公開（oh‑my‑codex）、バージョンバッジでアクティブなリリースを示す。
• 元の作者（Yeachan Heo）と少数のコントリビューターによるメンテナンス。
• ガイド（導入、エージェント、スキル、統合）が充実しており、サポート用の Discord コミュニティも提供。

結論 – すでに Codex を使っているが、手動でプロンプトを調整している場合、OMX は準備完了のスクリプタブルなワークフロー、永続的な状態、より洗練されたターミナル UI を提供し、一時的なプロンプト工学を再現可能な開発プロセスに変える。