Repolode
投稿する
Yeachan-Heo

Yeachan-Heo/oh-my-codex

OpenAI Codex CLIに構造化された計画立案、目標の継続的な実行、並列エージェントチーム、.omx/での状態管理を追加するワークフロー兼ランタイムレイヤー。

GitHub で見る公式サイト
スター
33,574
フォーク
2,549
未解決の Issue
1
最終コミット
9 時間前

これは何？

oh-my-codex（OMX）は、OpenAI Codex CLIの上に重ねて使うワークフローレイヤーです。実行エンジンはCodexのまま、要件の明確化（`$deep-interview`）から計画立案（`$ralplan`）、複数の目標を継続的に実行する仕組み（`$ultragoal`）へと進む標準的なフローを追加します。ストーリー内で連携して並列作業を行う場合は、`$team`を利用できます。

OMXには、再利用可能な専門家ロールとスキル、スコープを指定したAGENTS.mdファイルによるプロジェクト向けガイダンス、セッションを別々のgit worktreeで実行できる起動ラッパーが用意されています。計画、ログ、メモリ、モードの状態は、プロジェクト内の`.omx/`ディレクトリに保存されます。また、プロンプトを順番に実行するミッションランナー、セッションのエクスポートやトークン使用量を確認するコマンド、tmuxベースのモニタリングHUDも備えています。

主な対象はmacOSとLinuxで、Codex CLIとの利用が推奨されています。ネイティブのWindowsサポートは副次的な位置付けです。npmでインストールでき、Node.js 20以降が必要です。

主な機能

  • 01要件の明確化から計画立案、継続的な実行までをつなぐ標準ワークフロー
  • 02`.omx/ultragoal`配下のチェックポイント台帳で進捗を管理する、複数目標の継続的な実行
  • 03tmuxと専用のgit worktreeを使った並列エージェントチーム
  • 04同時進行するセッションを名前付きworktreeで分離する起動ラッパー
  • 05ステータス確認と再開に対応した、プロンプトを順番に実行するミッションランナー
  • 06セッションのエクスポート、タイムライン、トークン使用量を確認するコマンド

ユースケース

  • 曖昧な機能リクエストを、Codexがコードを編集する前に承認済みの計画へ落とし込む
  • 複数のセッションにまたがってチェックポイント付きで進捗を管理しながら、長期的な複数ステップのリファクタリングを実行する
  • 大規模なタスクを、別々のworktreeで動く並列ワーカーの作業レーンに分割する
  • Codex向けのプロンプトをチェックリストとしてまとめ、無人で順番に実行する

クイックスタート

  1. 1

    npm で Codex CLI をインストールします（Homebrew でインストール済みの場合はスキップ）

    npm install -g @openai/codex
  2. 2

    oh-my-codex をグローバルにインストールします

    npm install -g oh-my-codex
  3. 3

    doctor チェックを実行して、インストールを確認します

    omx doctor
  4. 4

    git プロジェクト内から OMX を起動します

    omx

使う前に知っておきたいこと

  • 主に macOS または Linux 向けです。ネイティブの Windows はサポートが限定的で、動作が不安定になる場合があります。
  • Node.js 20 以降と、認証済みの Codex CLI が必要です。
  • 推奨される永続的なチーム実行環境には、macOS または Linux で tmux が必要です。
  • --madmax フラグを使うと Codex の承認とサンドボックスの保護機能が無効になるため、信頼できる環境でのみ使用してください。

トピック

#codex#ai-agents#workflow#llm#cli#tmux#git-worktree#typescript

よくある質問

oh-my-codex とは？
OpenAI Codex CLIに構造化された計画立案、目標の継続的な実行、並列エージェントチーム、.omx/での状態管理を追加するワークフロー兼ランタイムレイヤー。 oh-my-codex（OMX）は、OpenAI Codex CLIの上に重ねて使うワークフローレイヤーです。実行エンジンはCodexのまま、要件の明確化（`$deep-interview`）から計画立案（`$ralplan`）、複数の目標を継続的に実行する仕組み（`$ultragoal`）へと進む標準的なフローを追加します。ストーリー内で連携して並列作業を行う場合は、`$team`を利用できます。
oh-my-codex は無料で使えますか？ライセンスは？
oh-my-codex は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
oh-my-codex は今もメンテナンスされていますか？
活発にメンテナンス中。oh-my-codex の最終コミットは 2026年10月20日 です。
oh-my-codex は何に使えますか？
曖昧な機能リクエストを、Codexがコードを編集する前に承認済みの計画へ落とし込む 複数のセッションにまたがってチェックポイント付きで進捗を管理しながら、長期的な複数ステップのリファクタリングを実行する 大規模なタスクを、別々のworktreeで動く並列ワーカーの作業レーンに分割する Codex向けのプロンプトをチェックリストとしてまとめ、無人で順番に実行する
oh-my-codex のインストール方法は？
npm で Codex CLI をインストールします（Homebrew でインストール済みの場合はスキップ）: npm install -g @openai/codex oh-my-codex をグローバルにインストールします: npm install -g oh-my-codex doctor チェックを実行して、インストールを確認します: omx doctor git プロジェクト内から OMX を起動します: omx
oh-my-codex はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/Yeachan-Heo/oh-my-codex

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト