tmux セッションコントロール

キーストロークを送信して出力を読み取ることで、tmux セッションを制御します。Claude Code セッションの管理に必須です。

使用するべき場合

✅ このスキルを使用する場合:

• tmux で Claude/Codex セッションを監視する
• インタラクティブなターミナルアプリケーションに入力を送信する
• tmux で実行中の長時間実行プロセスから出力をスクレイピングする
• プログラムで tmux ペイン/ウィンドウをナビゲートする
• 既存セッション内のバックグラウンド作業を確認する

使用してはいけない場合

❌ このスキルを使用しない場合:

• ワンオフシェルコマンドを実行する → 代わりに exec ツールを直接使用
• 新しいバックグラウンドプロセスを開始する → exec と background:true を使用
• インタラクティブでないスクリプト → exec ツールを使用
• プロセスが tmux にない
• 新しい tmux セッションを作成する必要がある → exec と tmux new-session を使用

セッション例

セッション	目的
shared	メインのインタラクティブセッション
worker-2 - worker-8	並列ワーカーセッション

よく使うコマンド

セッションのリスト表示

tmux list-sessions
tmux ls

出力をキャプチャ

# ペインの最後の 20 行
tmux capture-pane -t shared -p | tail -20

# 全スクロールバック
tmux capture-pane -t shared -p -S -

# ウィンドウ内の特定ペイン
tmux capture-pane -t shared:0.0 -p

キーを送信

# テキストを送信 (Enter キーは押さない)
tmux send-keys -t shared "hello"

# テキスト + Enter を送信
tmux send-keys -t shared "y" Enter

# 特殊キーを送信
tmux send-keys -t shared Enter
tmux send-keys -t shared Escape
tmux send-keys -t shared C-c          # Ctrl+C
tmux send-keys -t shared C-d          # Ctrl+D (EOF)
tmux send-keys -t shared C-z          # Ctrl+Z (サスペンド)

ウィンドウ/ペインナビゲーション

# ウィンドウを選択
tmux select-window -t shared:0

# ペインを選択
tmux select-pane -t shared:0.1

# ウィンドウをリスト表示
tmux list-windows -t shared

セッション管理

# 新規セッション作成
tmux new-session -d -s newsession

# セッションを削除
tmux kill-session -t sessionname

# セッションをリネーム
tmux rename-session -t old new

安全に入力を送信する

インタラクティブ TUI (Claude Code, Codex など) の場合、テキストと Enter をペースト/複数行のエッジケースを避けるために別々に送信してください:

tmux send-keys -t shared -l -- "Please apply the patch in src/foo.ts"
sleep 0.1
tmux send-keys -t shared Enter

Claude Code セッションのパターン

セッションが入力を必要とするか確認

# プロンプトを探す
tmux capture-pane -t worker-3 -p | tail -10 | grep -E "❯|Yes.*No|proceed|permission"

Claude Code プロンプトを承認

# 'y' と Enter を送信
tmux send-keys -t worker-3 'y' Enter

# または番号付きオプションを選択
tmux send-keys -t worker-3 '2' Enter

すべてのセッションのステータスを確認

for s in shared worker-2 worker-3 worker-4 worker-5 worker-6 worker-7 worker-8; do
  echo "=== $s ==="
  tmux capture-pane -t $s -p 2>/dev/null | tail -5
done

セッションにタスクを送信

tmux send-keys -t worker-4 "Fix the bug in auth.js" Enter

注意事項

• capture-pane -p を使用して stdout に出力します (スクリプト作成に必須)
• -S - は全スクロールバック履歴をキャプチャします
• ターゲット形式: session:window.pane (例: shared:0.0)
• セッションは SSH 切断後も保持されます