omx について
omxは、Codex CLI向けのワークフローおよびランタイムレイヤーで、コーディングエージェントや反復的な開発作業を調整する開発者向けです。再利用可能なロール別プロンプト、ワークフロースキル、tmuxチーム、リポジトリ調査用CLIを組み合わせます。
主な機能
- 01専門エージェント向けの再利用可能なプロンプト
- 02計画、実装、レビューのワークフロースキル
- 03tmuxワーカーによる並列チーム
- 04セットアップと診断用CLIツール
- 05読み取り専用の探索と範囲を限定したシェル検査
活用シーン
- 01複数エージェントでリファクタリングを並行
- 02継続的な修正と検証のループを実行
- 03認証変更を計画してレビュー
- 04ファイルを変更せずにリポジトリを調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/omxを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
SKILL.toonevals/evals.jsonreferences/agents-catalog.mdcli-reference.mdparallel-quality-workflows.mdskills-reference.mdscripts/install.shvalidate-cross-runtime-workflows.pyvalidate-omx.shskill-autoresearch-omx/changelog.mddashboard.htmlresults.jsonresults.tsvSKILL.md.baseline詳細
omx (oh-my-codex) — Codex CLI 向けマルチエージェントオーケストレーション
このスキルを使う場面
- 再利用可能な役割別プロンプトやワークフロースキルを備えた、より強力な Codex CLI の実行環境が必要な場合
- tmux チームワーカーを使って、連携する並列エージェントが必要な場合
- Claude の
/team、/autopilot、/ultrawork、/ultraqaに相当する Codex／OMX の機能が必要な場合 - 永続的な実行（
$ralph）や合意形成型の計画（$ralplan）を必要とする複雑なタスク - リポジトリの調査（
omx explore）や範囲を限定したシェルの調査（omx sparkshell）が必要な場合 $ask-claudeまたは$ask-geminiによるモデル間の相談が必要な場合
1. クイックスタート
npm install -g @openai/codex oh-my-codex
omx setup
omx --madmax --high
Codex 内で：
/prompts:architect "analyze the authentication flow"
$plan "map the safest implementation path"
基本的な考え方：エージェントの作業は Codex が行います。OMX は、より優れたプロンプト、再利用可能なワークフロースキル、そしてその周囲の実行レイヤーを追加します。
omx --madmax --highから始め、タスクに応じてエージェントに$team、$ralphなどのワークフローを使わせてください。
2. エージェントの役割（30 以上）
| ティア | エージェント |
|---|---|
| コア開発 | architect · planner · executor · debugger · verifier · explore |
| 品質保証 | style-reviewer · quality-reviewer · api-reviewer · security-reviewer · performance-reviewer |
| ドメインエキスパート | dependency-expert · test-engineer · build-fixer · designer · writer · qa-tester |
| プロダクト戦略 | product-manager · ux-researcher · product-analyst · information-architect |
呼び出し方法：/prompts:<agent-name> "task"
3. ワークフロースキル（35 以上）
| スキル | トリガー | 説明 |
|---|---|---|
autopilot | $autopilot | アイデアから動作するコードまでを担う、完全自律型のパイプライン |
ralph | $ralph | 完了が検証されるまで続く、永続的な実行ループ |
ultrawork | $ulw, $ultrawork | 独立したエージェント間の並列性を最大化 |
team | $team | tmux／worktree による分離環境で連携する N 個のエージェント |
plan | $plan | 実装前の戦略的な計画 |
ralplan | $ralplan | 合意に基づく反復的な計画 |
deep-interview | $deep-interview | 計画または実行前の、ソクラテス式の確認 |
deepsearch | $deepsearch | コードベースに焦点を当てた詳細な検索 |
analyze | $analyze | 証拠に基づく因果分析（トレース手法） |
tdd | $tdd | テストファースト開発（レッド・グリーン・リファクタリング） |
build-fix | $build-fix | ビルドエラー、型エラー、ツールチェーンの障害を修正 |
code-review | $code-review | 多角的な包括的コードレビュー |
security-review | $security-review | セキュリティ監査 — 脆弱性、信頼境界 |
ultraqa | $ultraqa | 並列性を最大化した QA／レビュー |
visual-verdict | $visual-verdict | 判定付きの UI／UX ビジュアルレビュー |
frontend-ui-ux | $frontend-ui-ux | フロントエンドの UI／UX デザインとレビュー |
ai-slop-cleaner | $ai-slop-cleaner | コードやドキュメントから AI 特有の表現パターンを除去 |
ask-claude | $ask-claude | Claude とのモデル間相談 |
ask-gemini | $ask-gemini | Gemini とのモデル間相談 |
git-master | $git-master | アトミックコミット、リベース、履歴管理 |
ecomode | $ecomode | トークン効率を重視した実行モード |
web-clone | $web-clone | Web ページや UI パターンを複製して適応 |
cancel | $cancel | 実行中のモードを停止 |
4. チーム実行環境
# Start parallel team workers
omx team 3:executor "fix all TypeScript errors"
omx team 2:security-reviewer,1:architect "audit auth module"
# Team management
omx team status <team-name>
omx team resume <team-name>
omx team shutdown <team-name>
Codex 内で：
$team 3:executor "parallelize this refactor"
要件：
| プラットフォーム | 依存関係 |
|---|---|
| macOS | brew install tmux |
| Ubuntu/Debian | sudo apt install tmux |
| Fedora | sudo dnf install tmux |
| Windows（ネイティブ） | winget install psmux |
| Windows（WSL2） | sudo apt install tmux |
5. Claude ワークフローとの同等性
Codex で Claude スタイルの team、autopilot、ultrawork、または ultraqa を使用するよう求められた場合は、references/parallel-quality-workflows.md をお読みください。
| Claude / OMC の意図 | OMX コマンド | 使用する場面 |
|---|---|---|
/team N:role "task" | $team N:role "task" または omx team N:role "task" | 共有タスクリストと分離されたワーカーによる連携作業が必要な場合 |
/autopilot "task" または autopilot: task | $autopilot "task" | アイデア → 計画 → 実装 → 検証までを Codex ネイティブで完結させる場合 |
/ultrawork "task" | $ulw "task" または $ultrawork "task" | 同期を最小限に抑えて、独立した作業レーンを実行できる場合 |
/ultraqa "target" | $ultraqa "target" | テスト、セキュリティ、パフォーマンス、UI の観点で QA／レビューを並列化する場合 |
Claude セッションの .omc/state/ を再利用しないでください。OMX の状態と一時ファイルは .omx/ 配下に置きます。
新規プロジェクトに関する曖昧な依頼では、$autopilot の前に $deep-interview を実行してください。高い保証が求められる完了ループでは、$ralph の前に $plan または $ralplan を使用してください。
6. CLI コマンド
コア起動
omx # Launch Codex with OMX runtime
omx --madmax --high # Recommended default (bypass + high reasoning)
omx --xhigh # Extra-high reasoning effort
起動フラグ
| フラグ | 説明 |
|---|---|
--yolo | 高速実行。検証は最小限です |
--high | 高い推論能力を使用します |
--xhigh | さらに高い推論能力を使用します |
--madmax | 承認／サンドボックスをバイパスします（--dangerously-bypass-approvals-and-sandbox） |
--dry-run | 実行せずにプレビューします |
--verbose | 詳細な出力を表示します |
オペレーターコマンド
omx setup # Install prompts, skills, config, AGENTS scaffolding
omx doctor # Verify installation
omx doctor --team # Team/swarm diagnostics
omx status # Show active modes
omx cancel # Cancel execution modes
omx hud --watch # Live HUD status monitor
omx reasoning <mode> # Set: low/medium/high/xhigh
omx help # Show help
探索と確認
omx explore --prompt "find where team state is written" # Read-only repo lookup
omx sparkshell git status # Bounded shell inspection
omx sparkshell --tmux-pane %12 --tail-lines 400 # Tail tmux pane output
使用方法
- 意図を特定する — 依頼に最適なワークフロースキル（
$autopilot、$plan、$ralph、$team、$deep-interview）を選びます - 推奨される起動方法から始める — ほとんどのセッションでは
omx --madmax --highを使用します - 分析にはロールプロンプトを使用する — 実装の前に
/prompts:architect "..."を実行します - 必要に応じて段階を上げる — 完全自律型のビルドを意図する場合は
$autopilot、連携するワーカーには$team、独立した短期集中作業には$ulw、QA の並列化には$ultraqaを使用します - 曖昧な依頼には
$deep-interviewを使用する — 意図、範囲、境界が不明確な場合に使用します - 参考資料を示す — 詳細については、関連する references/ ファイルへのリンクを記載します
例
例 1：標準的なセッション
omx --madmax --high
/prompts:architect "analyze the current auth flow"
$plan "implement OAuth safely"
例 2：継続的な実行
$ralph "fix all failing tests and make them pass"
すべてのテストに合格するまで、実行 → 検証 → 修正を繰り返します。
例 3：並列チーム作業
omx team 3:executor "refactor the API layer with proper tests"
例 4：Claude の ultrawork／ultraqa と同等の使い方
$autopilot "build the task API end to end"
$ulw "parallelize the independent cleanup tasks"
$ultraqa "review the auth flow across tests, security, and performance"
例 5：コーディング前の確認
$deep-interview "I want to add a payment system"
意図が明確になるまで、一度に1つの質問をするソクラテス式のやり取りを続け、その後 $plan または $ralph に引き継ぎます。
ベストプラクティス
- Codex を優先する — OMX はワークフローレイヤーであり、Codex の代替ではありません。
omx --madmax --highから始めます $ralphの前に$planを使用する — 範囲が不明確な場合は先に計画し、確実な実行には ralph を使用します- 合意形成には
$ralplanを使用する — 取り掛かる前に複数の計画視点が必要な場合に使用します $deep-interviewを実行の前提とする — 曖昧な新規プロジェクトまたは既存プロジェクトの作業では、必ず使用します- チームモードは任意です — 連携するワーカーには
$team、独立した短期集中作業には$ulw、QA の並列化には$ultraqaを使用します - モデルを横断した相談 — 設計やアーキテクチャについて別の意見を得るには、
$ask-claudeと$ask-geminiを使用します - 安全な参照には
omx exploreを使用する — 読み取り専用のため、何も変更しません - 行き詰まったら
omx doctorを使用する — 手動でデバッグする前に、インストールの問題を診断します
クイックリファレンス
| コマンド／スキル | アクション |
|---|---|
omx --madmax --high | 推奨される起動方法 |
/prompts:architect "..." | 分析と設計レビュー |
$autopilot "..." | アイデアから動作するコードまでを自律的に進めるパイプライン |
$plan "..." | 戦略的な計画 |
$deep-interview "..." | 曖昧なリクエストを明確化 |
$ralph "..." | 完了するまで継続するループ |
$ralplan "..." | 合意形成のための計画 |
$team N:role "..." | 複数のエージェントを並列で連携 |
$ulw "..." | 最大限の並列処理 |
$ultraqa "..." | QA／レビューを並列で集中実行 |
omx explore --prompt "..." | リポジトリを読み取り専用で調査 |
omx sparkshell <cmd> | 範囲を限定したシェルの調査 |
omx setup | OMX をインストール／再インストール |
omx doctor | 問題を診断 |
omx cancel / $cancel | アクティブなモードをキャンセル |
参考資料
| ファイル | 内容 |
|---|---|
| references/agents-catalog.md | 30 種類以上のエージェントプロファイルとユースケースすべて |
| references/skills-reference.md | トリガーと説明を含むスキルの全リスト |
| references/cli-reference.md | CLI の完全なリファレンス：omx team/explore/sparkshell/reasoning |
| references/parallel-quality-workflows.md | Codex/OMX 向けの Claude team/autopilot/ultrawork/ultraqa 相当機能 |
コメント
Markdown 対応