omc-setup

OMC のセットアップ

覚える必要があるコマンドはこれだけです。これを実行すれば、あとはすべて自動で行われます。

このスキルが呼び出されたら、以下のワークフローを直ちに実行してください。これらの指示をユーザーに言い換えたり、要約したりするだけで終わらせないでください。

注：このガイド内のすべての ~/.claude/... パスは、環境変数 CLAUDE_CONFIG_DIR が設定されている場合、その値に従います。

最適な用途

ユーザーがOMC 自体をインストール、更新、または修復したい場合は、このセットアップフローを選択してください。

• マーケットプレイス／プラグインのインストールユーザーは、/plugin install oh-my-claudecode の実行後にここへ進みます
• npm ユーザーは、npm i -g oh-my-claude-sisyphus@latest の実行後にここへ進みます
• ローカル開発およびワークツリーユーザーは、チェックアウト済みリポジトリを更新してセットアップを再実行した後にここへ進みます

フラグの解析

ユーザーの呼び出しに含まれるフラグを確認してください。

• --help → ヘルプテキスト（以下）を表示して終了
• --local → フェーズ 1 のみ実行（target=local）して終了
• --global → フェーズ 1 のみ実行（target=global）して終了
• --force → セットアップ前チェックをスキップし、セットアップ全体を実行（フェーズ 1 → 2 → 3 → 4）
• フラグなし → セットアップ前チェックを実行し、必要に応じてセットアップ全体を実行

ヘルプテキスト

ユーザーが --help を指定して実行した場合、以下を表示して終了してください。

OMC Setup - Configure oh-my-claudecode

USAGE:
  /oh-my-claudecode:omc-setup           Run initial setup wizard (or update if already configured)
  /oh-my-claudecode:omc-setup --local   Configure local project (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Configure global settings (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Force full setup wizard even if already configured
  /oh-my-claudecode:omc-setup --help    Show this help

MODES:
  Initial Setup (no flags)
    - Interactive wizard for first-time setup
    - Configures CLAUDE.md (local or global)
    - Sets up HUD statusline
    - Checks for updates
    - Clears retired setup values (5.0.0 removed defaultExecutionMode) and points MCP registration at Claude Code's native config
    - Configures team mode defaults (agent count, type, model)
    - If already configured, offers quick update option

  Local Configuration (--local)
    - Invokes the plugin-local coordinator through `scripts/setup-claude-md.sh`; the shell validates the coordinator response and its exit status before any post-install work
    - Reports coordinator-created byte-identical backups only for files that required mutation
    - Project-specific settings
    - Use this to update project config after OMC upgrades

  Global Configuration (--global)
    - Invokes the plugin-local coordinator through `scripts/setup-claude-md.sh`; the shell validates the coordinator response and its exit status before any post-install work
    - Reports coordinator-created byte-identical backups only for changed global files
    - Default: explicitly overwrites ~/.claude/CLAUDE.md so plain `claude` also uses OMC
    - Optional preserve mode keeps the user's base `CLAUDE.md` and installs OMC into `CLAUDE-omc.md` for `omc` launches
    - Applies to all Claude Code sessions
    - Preserves same-named legacy hook files unless their exact historical contents are independently verified
    - Use this to update global config after OMC upgrades

  Force Full Setup (--force)
    - Bypasses the "already configured" check
    - Runs the complete setup wizard from scratch
    - Use when you want to reconfigure preferences

EXAMPLES:
  /oh-my-claudecode:omc-setup           # First time setup (or update CLAUDE.md if configured)
  /oh-my-claudecode:omc-setup --local   # Update this project
  /oh-my-claudecode:omc-setup --global  # Update all projects
  /oh-my-claudecode:omc-setup --force   # Re-run full setup wizard

For more info: https://github.com/Yeachan-Heo/oh-my-claudecode

セットアップの呼び出し

このスキル内でプラグインキャッシュディレクトリを個別にスキャンしたり、プラグインルートを選択したりしないでください。実行中のプラグイン環境から提供されたプラグインルートを使って、セットアップスクリプトを呼び出してください。

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" <local|global> [overwrite|preserve]

このスクリプトがキャッシュの解決を一元的に担います。完全なプラグインルート（正規の docs/CLAUDE.md、コーディネーター成果物、wiki スキル）だけを受け付け、厳密な完全 SemVer のキャッシュバージョンを選択し、コンパイル済みソースのハンドシェイクを検証します。また、コーディネーターのプロトコルまたはステータスに不一致がある場合は、安全のため処理を失敗させます。コーディネーターを介さずに設定をダウンロードしたり、CLAUDE.md を変更したりしないでください。

セットアップ前チェック：設定済みですか？

重要：ほかの作業を始める前に、セットアップがすでに完了しているか確認してください。これにより、更新のたびにセットアップウィザード全体を再実行する必要がなくなります。

# Check if setup was already completed
CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
case "$CONFIG_DIR" in
  "~") CONFIG_DIR="$HOME" ;;
  "~/"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\~/}" ;;
  "~\\"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\~\\}" ;;
esac
CONFIG_FILE="$CONFIG_DIR/.omc-config.json"

if [ -f "$CONFIG_FILE" ]; then
  if ! command -v jq >/dev/null 2>&1; then
    echo "ERROR: jq is required to inspect existing OMC setup state. Existing config was not modified."
    exit 1
  fi
  if ! SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null) \
    || ! SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null); then
    echo "ERROR: Existing OMC config is invalid JSON. Existing config was not modified."
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "OMC setup was already completed on: $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Setup version: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

設定済みの場合（--force フラグがない場合）

ALREADY_CONFIGURED が true で、ユーザーが --force、--local、--global フラグを指定していない場合：

AskUserQuestion を使って、次の質問をしてください。

質問：「OMC はすでに設定されています。どうしますか？」

選択肢：

1. CLAUDE.md を更新し、廃止されたセットアップ値を削除する - 有効なプラグインの正規の CLAUDE.md をインストールし、セットアップ全体を再実行せずにフェーズ 2 のステップ 2.4 を実行します
2. セットアップ全体を再実行する - セットアップウィザード全体を実行します
3. キャンセル - 変更せずに終了します

ユーザーが「CLAUDE.md を更新し、廃止されたセットアップ値を削除する」を選択した場合：

• ローカル（.claude/CLAUDE.md）またはグローバル（~/.claude/CLAUDE.md）の設定ファイルがあるか確認します
• ローカル設定がある場合、bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local を実行します
• グローバル設定のみがある場合、bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global を実行します
• フェーズ 2 のステップ 2.4 を実行し、廃止された defaultExecutionMode キーを削除します
• クリーンアップ後は、ほかのすべてのステップをスキップします
• 成功を報告して終了します

ユーザーが「セットアップ全体を再実行する」を選択した場合：

• 以下の再開検出に進みます

ユーザーが「キャンセル」を選択した場合：

• 変更せずに終了します

Force フラグによる上書き

ユーザーが --force フラグを指定した場合、このチェックをスキップしてセットアップに直接進みます。

再開検出

いずれかのフェーズを開始する前に、既存の状態を確認してください。

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" resume

状態が存在する場合（出力が "fresh" ではない場合）、AskUserQuestion を使って次の質問をしてください。

質問：「前回のセットアップセッションが見つかりました。再開しますか、それとも最初から始めますか？」

選択肢：

1. ステップ $LAST_STEP から再開する - 中断したところから続行します
2. 最初から始める - 最初から開始します（保存された状態を消去します）

ユーザーが「最初から始める」を選択した場合：

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" clear

フェーズの実行

--local または --global フラグの場合：

${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md のファイルを読み、その指示に従ってください。 （フェーズファイルがフラグモードでの早期終了を処理します。）

完全なセットアップ（デフォルトまたは --force）の場合：

各フェーズを順番に実行します。各フェーズでは、対応するファイルを読み、その指示に従ってください。

1. フェーズ 1 - CLAUDE.md のインストール：${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md を読み、その指示に従ってください。

2. フェーズ 2 - 環境設定：${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md を読み、その指示に従ってください。フェーズ 2 では、HUD／statusLine のセットアップを hud スキルに委任する必要があります。この場で statusLine のパスをインラインで生成またはパッチしないでください。

3. フェーズ 3 - インテグレーションのセットアップ：${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md を読み、その指示に従ってください。

4. フェーズ 4 - 完了：${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md を読み、その指示に従ってください。

中断時の適切な処理

重要：このセットアッププロセスでは、各フェーズの後に ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh を使って進行状況を保存します。中断（Ctrl+C または接続切断）された場合、続きからセットアップを再開できます。

最新の状態を保つ

npm またはプラグインのアップデートで oh-my-claudecode を更新した後：

自動：/oh-my-claudecode:omc-setup を実行するだけで、すでに設定済みであることを検出し、残りのウィザードを省略する「CLAUDE.md を更新し、廃止されたセットアップ値を削除」する簡易オプションを提示します。

簡易更新パスでも、アップグレード時に廃止された defaultExecutionMode の値を削除できるよう、フェーズ 2 のステップ 2.4 を必ず実行してください。代替となる実行モード設定を書き込んではいけません。

手動での選択肢：

• /oh-my-claudecode:omc-setup --local でプロジェクト設定のみを更新
• /oh-my-claudecode:omc-setup --global でグローバル設定のみを更新
• /oh-my-claudecode:omc-setup --force でウィザード全体を再実行（設定を再構成）

これにより、セットアップ全体を繰り返すトークンコストをかけずに、最新の機能とエージェント設定を利用できます。