omx-setup

OMX セットアップ

このタスクカードは、現在のプロジェクトやユーザースコープに OMX をインストールまたは更新するために使用します。共通の安全性、ライフサイクル、フック、チーム、自律性、キャンセルのルールは templates/AGENTS.md にあります。このカードから新しい CLI の動作を推測しないでください。実装が正となります。

コマンドと代替手段

omx setup [--force] [--merge-agents|--no-merge-agents|--clear-merge-agents-policy] [--dry-run] [--verbose] [--scope <user|project>] [--plugin|--legacy|--install-mode <legacy|plugin>] [--mcp <none|compat>] [--no-mcp|--with-mcp] [--disable-team|--enable-team|--team-mode <enabled|disabled>]
omx agents-init [path] [--dry-run] [--force] [--verbose]

agents-init は、完全なインストールではなく、軽量な AGENTS.md の雛形作成のみに使用します。

サポートされているセットアップオプション:

• --force: 管理対象のアーティファクトを上書き/再インストールします。一時的なものであり、永続化や再実行はされません。
• --merge-agents、--no-merge-agents、--clear-merge-agents-policy: 値や等号を付けない、そのままのセレクターです。同一のセレクターを繰り返し指定しても冪等です。競合するセレクターは、変更が行われる前に失敗します。設定すると、呼び出し元のプロジェクトルートごとに明示的なポリシーが保存されます。クリアするとそれが削除され、設定と組み合わせることはできません。マージは管理対象セクションを更新します。no-merge はそのブランチを抑制するだけで、保持モードではありません。
• --dry-run、--verbose: 操作をプレビューするか、ファイルごと/ステップごとの詳細を表示します。
• --scope user|project: user (~/.codex、~/.omx/agents) または project (./.codex、./.omx/agents) のどちらを対象にするかを選択します。
• --plugin / --legacy: 配布モードを選択します。--install-mode legacy|plugin が正式なスクリプト用の指定方法です。競合するモードフラグは失敗します。
• --mcp none|compat（--no-mcp / --with-mcp も可）: ファーストパーティの MCP 互換機能と共有レジストリの同期を省略または有効化します。
• --disable-team、--enable-team、--team-mode enabled|disabled: Team のスキル/コンテキスト生成を選択します。競合するセレクターは失敗します。

セットアップの決定

1. スコープ: 明示的なフラグ、有効な永続化済みの ./.omx/setup-scope.json、TTY での選択（デフォルトは user）、または非対話時の user の順に決定します。レガシーの project-local は project に移行されます。
2. モード: 明示的なフラグ、保持されている場合は永続化されたモード、name: oh-my-codex を持つ ${CODEX_HOME:-~/.codex}/plugins/cache/**/.codex-plugin/plugin.json が見つかった場合（プラグインがデフォルト）、それ以外はレガシーです。TTY での再実行時は保存済みの選択内容を要約し、保持/確認/リセットを提示します。非対話実行はブロックされません。
3. 必要なディレクトリを作成し、セットアップが正常に完了した後にのみ、設定をアトミックに永続化します。

セットアップで変更される内容

• レガシーモードでは、プロンプト/ネイティブエージェント/スキルをインストールし、config.toml を完全にマージします。
• プラグインモードでは、レガシーの OMX 管理プロンプト/スキルをアーカイブまたは削除し、インストール可能なネイティブエージェントの TOML を更新するとともに、古く生成されたインストール不可のエージェントを更新し、セットアップが所有するランタイムフックを維持します。
• 両モードとも、ビルド済みの dist/cli/team.js 内の Team CLI の相互運用マーカーを検証し、選択された場合または許可された場合にのみ AGENTS のデフォルトを生成し、./.omx/hud-config.json を書き込みます。通知フックの参照は、プラグインスキルの配布以外ではセットアップが所有します。
• AGENTS.md は ./AGENTS.md です。--force または --merge-agents を指定しない場合、対話実行では上書き前に確認し、非対話実行では既存ファイルを保持します。アクティブセッションの安全機構により、書き込みがスキップされる場合があります。プラグインモードでは、AGENTS と developer_instructions のデフォルトについて別途確認することがあります。非対話実行では既存ファイルを保持します。
• プラグインモードでは、セットアップが所有するランタイムフラグ（plugin_hooks、goals、またはレガシーの hooks/codex_hooks フォールバック）を有効にします。プロジェクトスコープでは、明示的に上書きされない限り CODEX_HOME=./.codex を使用します。

検証

omx setup --force --verbose
omx doctor

選択されたスコープにおけるプロンプトとスキル、プロジェクトルートの AGENTS.md、.omx/state、およびスコープ対象の config.toml にある CLI 優先の設定について、doctor の確認結果が表示されることを期待してください。ファーストパーティの MCP と共有レジストリの同期は、セットアップで --mcp compat を使用しない限り省略されます（インストール済みの CLI がサポートしている場合）。

ローカルのソースを使用する場合は、node dist/cli/omx.js setup --force --verbose および node dist/cli/omx.js doctor の前に npm run build を実行してください。AGENTS が上書きもマージもされなかった場合は、アクティブな OMX セッションを停止し、--force または --merge-agents を付けて再実行してください。ライフサイクルの状態を手動で編集しないでください。

Discovery troubleshooting

$omx-setup が存在しない、または古い場合は、omx setup --verbose を実行してから omx doctor を実行してください。プロジェクトスコープの場合は ./.codex/skills/omx-setup/SKILL.md を、レガシーのユーザースコープの場合は ${CODEX_HOME:-~/.codex}/skills/omx-setup/SKILL.md を確認してください。プラグインモードでは、oh-my-codex プラグインがインストールされ、検出されていることを確認してください。重複がある場合は、過去の ~/.agents/skills との重なりを調べ、doctor/setup のクリーンアップ案内に従ってください。

Exit contract

選択されたスコープ/モード、ドライラン対変更の別、AGENTS ポリシー、影響を受けるルート、doctor の指標を報告してください。セットアップが正常に完了し、検証で想定どおりのファイル/設定が確認できた後にのみ停止してください。失敗した場合は、コマンドの出力をそのまま残し、最小限の修正コマンドを再実行してください。ドライランのみでインストールを完了したとみなさないでください。