oh-my-codex

cmux omxはOh My Codex (OMX)をcmux対応環境で起動します。OMXは30以上の専門エージェントロール、ワークフロースキル、tmuxベースの並列チーム実行を持つOpenAI Codex CLIのマルチエージェントオーケストレーションレイヤーです。チームペインやHUDはネイティブのcmuxスプリットになります。

使い方

cmux omx
cmux omx --madmax --high
cmux omx team

omxの後のすべての引数はomx CLIに転送されます。

機能

OMXのチームモードとHUDはtmuxでペイン管理します。cmux omxではネイティブcmuxスプリットになります:

  • チームワーカーペイン(Codex/Claudeセッション)がワークスペース内のcmuxスプリットとして表示
  • HUDステータス表示がスプリットペインでモデル、ブランチ、コンテキスト、トークン使用量を表示
  • 自動レイアウト管理がエージェントペインをメインバーティカルグリッドに配置
  • ワーカーが横で動作している間、メインセッションはプライマリペインに維持

前提条件

npm install -g @openai/codex oh-my-codex
omx setup
omx doctor

OMXにはOpenAI Codex CLIと有効なCodex認証設定が必要です。omx doctorでインストールを確認してください。

仕組み

他のcmuxエージェント連携と同じパターンです。tmux shimがOMXからのtmuxコマンドを傍受し、cmux APIコールに変換します。

  • ~/.cmuxterm/omx-bin/tmuxにtmux shimを作成
  • TMUXとTMUX_PANE環境変数を設定
  • shimディレクトリをPATHの先頭に追加
  • すべての引数を転送してomxにexec

ディレクトリ

パス目的
~/.cmuxterm/omx-bin/tmux shimスクリプトを含む
~/.cmuxterm/tmux-compat-store.jsontmux-compatバッファとフックの永続ストレージ

環境変数

変数目的
TMUX現在のcmuxワークスペースとペインをエンコードした偽のtmuxソケットパス
TMUX_PANE現在のcmuxペインにマッピングされた偽のtmuxペイン識別子
CMUX_SOCKET_PATHshimが接続するcmuxコントロールソケットのパス