background-command

background-command スキル

長時間常駐するコマンド（開発サーバ・ファイル監視・watch ビルド・HTTP サーバ等）を実行するとき、Claude Code の bash tool の run_in_background を使うのではなく、oretachi の MCP ツールで oretachi UI 上に新しいターミナルタブを追加してそこで実行する。

これにより:

• 出力ログが xterm.js でユーザーに可視化される
• ユーザーが任意タイミングで Ctrl-C / kill できる
• 他ワークツリーへの切替・detach 等の oretachi 既存 UI が活用できる
• Claude Code 終了後もプロセスを残せる

いつこのスキルを使うか

使う（長時間常駐するコマンド）:

• pnpm dev, pnpm run dev, pnpm run tauri dev, npm start, yarn dev
• next dev, vite, nuxt dev, astro dev
• nodemon, tsc --watch, cargo watch, cargo run（HTTP サーバ等）
• docker compose up（-d なし）, rails s, flask run, python -m http.server
• その他、Ctrl-C しない限り終了しないコマンド全般

使わない（短命コマンド or 出力をすぐ後処理したいケース）:

• pnpm test, pnpm run build, cargo build, cargo check, tsc --noEmit, eslint ., prettier --check
• ビルド・テスト・lint・型チェック等、終了コードを判定したいもの
• ユーザーが明示的に「bash で background 実行して」と指示した場合
• 出力を即 grep / 解析したい短命スクリプト（curl, git log, ls 等）

判断基準: 「実行後ずっと起動し続けるか？」「Yes」ならこのスキル、「No」なら通常の bash。

ただし oretachi 設定の 「AI からの background コマンドを oretachi ターミナルで起動する」が OFF の場合は、上記判定で「Yes」でも本スキルは使わず Claude Code の bash tool（run_in_background: true）でフォールバック起動する。Step 0 で確認する。

手順

Step 0: グローバル設定を確認する

最初に oretachi_get_app_options を呼び、戻り値の useOretachiTerminalForBackground を見る。

oretachi_get_app_options({})
// => { "useOretachiTerminalForBackground": true | false }

• true: Step 1 以降に進む。
• false（既定）: 本スキルは使わない。Claude Code の bash tool で run_in_background: true を指定して起動する（例: bash tool で pnpm dev を実行、run_in_background: true）。oretachi UI には新タブを作らない。以降の Step もスキップ。

このトグルは oretachi 設定タブ → Terminal セクションの「AI からの background コマンドを oretachi ターミナルで起動する」に対応する。

Step 1: ワークツリーを特定する

oretachi_get_worktree_status を呼び、現在の作業ディレクトリ（PWD）と一致する worktree の name と id を取得する。

複数の worktree が同名だった場合は id も使う。

Step 2: ターミナルを起動してコマンドを流し込む

oretachi_spawn_terminal({
  worktree_name: "<Step 1 で取得した name>",
  worktree_id: "<必要なら id を指定>",
  command: "pnpm dev",
  title: "pnpm dev",            // タブ表示名
  reason: "ローカルサーバ起動"  // ログ用メモ（任意）
})