mcpField
T
tmux

tmux

github.com/volcengine開発41.7k147 回インストール1 日前に更新
リポジトリ

tmux について

対話型ターミナルセッションを必要とするエージェント向けの tmux スキルです。セッションの設定、入力、出力監視、終了に加え、複数のコーディングエージェントの並行実行方法も説明します。

主な機能

  1. 01分離ソケットとセッションの設定
  2. 02コマンドと制御キーの安全な送信
  3. 03ペイン出力の取得とプロンプト待機
  4. 04セッションの検索と終了
  5. 05コーディングエージェントの並行実行

活用シーン

  1. 01対話型 Python REPL の実行
  2. 02長時間のターミナルタスクの監視
  3. 03複数の worktree にまたがるエージェントの調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/volcengine/openviking --skill tmux

インストール後、Claude Code で/tmuxを入力して読み込まれたか確認します。

同梱ファイルscripts/find-sessions.shscripts/wait-for-text.sh

詳細

tmux スキル

対話型 TTY が必要な場合に限り tmux を使用してください。長時間実行する非対話型タスクには、exec のバックグラウンドモードを優先してください。

クイックスタート（分離ソケット、exec ツール）

SOCKET_DIR="${NANOBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/vikingbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/vikingbot.sock"
SESSION=vikingbot-python

tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200

セッションを開始したら、必ずモニター用コマンドを表示してください。

To monitor:
  tmux -S "$SOCKET" attach -t "$SESSION"
  tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200

ソケットの規則

  • NANOBOT_TMUX_SOCKET_DIR 環境変数を使用してください。
  • デフォルトのソケットパス："$NANOBOT_TMUX_SOCKET_DIR/vikingbot.sock"。

ペインの指定と名前付け

  • 指定形式：session:window.pane（デフォルトは :0.0）。
  • 名前は短くし、スペースは避けてください。
  • 確認：tmux -S "$SOCKET" list-sessions、tmux -S "$SOCKET" list-panes -a。

セッションの検索

  • ソケット上のセッションを一覧表示：{baseDir}/scripts/find-sessions.sh -S "$SOCKET"。
  • すべてのソケットをスキャン：{baseDir}/scripts/find-sessions.sh --all（NANOBOT_TMUX_SOCKET_DIR を使用）。

入力の安全な送信

  • リテラル送信を優先してください：tmux -S "$SOCKET" send-keys -t target -l -- "$cmd"。
  • 制御キー：tmux -S "$SOCKET" send-keys -t target C-c。

出力の確認

  • 最近の履歴を取得：tmux -S "$SOCKET" capture-pane -p -J -t target -S -200。
  • プロンプトを待機：{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'。
  • アタッチしてもかまいません。Ctrl+b d でデタッチしてください。

プロセスの起動

  • Python REPL では PYTHON_BASIC_REPL=1 を設定してください（通常の REPL では send-keys の処理が機能しません）。

Windows / WSL

  • tmux は macOS/Linux でサポートされています。Windows では WSL を使用し、WSL 内に tmux をインストールしてください。
  • このスキルは darwin/linux のみを対象としており、PATH 上に tmux が必要です。

コーディングエージェント（Codex、Claude Code）のオーケストレーション

tmux は複数のコーディングエージェントを並行して実行するのに適しています。

SOCKET="${TMPDIR:-/tmp}/codex-army.sock"

# Create multiple sessions
for i in 1 2 3 4 5; do
  tmux -S "$SOCKET" new-session -d -s "agent-$i"
done

# Launch agents in different workdirs
tmux -S "$SOCKET" send-keys -t agent-1 "cd /tmp/project1 && codex --yolo 'Fix bug X'" Enter
tmux -S "$SOCKET" send-keys -t agent-2 "cd /tmp/project2 && codex --yolo 'Fix bug Y'" Enter

# Poll for completion (check if prompt returned)
for sess in agent-1 agent-2; do
  if tmux -S "$SOCKET" capture-pane -p -t "$sess" -S -3 | grep -q "❯"; then
    echo "$sess: DONE"
  else
    echo "$sess: Running..."
  fi
done

# Get full output from completed session
tmux -S "$SOCKET" capture-pane -p -t agent-1 -S -500

ヒント：

  • 並行する修正には、別々の Git ワークツリーを使用してください（ブランチの競合を避けられます）。
  • 新しいクローンで codex を実行する前に、まず pnpm install を実行してください。
  • シェルプロンプト（❯ または $）を確認して、処理の完了を検出してください。
  • Codex で非対話型の修正を行うには、--yolo または --full-auto が必要です。

クリーンアップ

  • セッションを終了：tmux -S "$SOCKET" kill-session -t "$SESSION"。
  • ソケット上のすべてのセッションを終了：tmux -S "$SOCKET" list-sessions -F '#{session_name}' | xargs -r -n1 tmux -S "$SOCKET" kill-session -t。
  • プライベートソケット上のすべてを削除：tmux -S "$SOCKET" kill-server。

ヘルパー：wait-for-text.sh

{baseDir}/scripts/wait-for-text.sh は、タイムアウトを指定してペインをポーリングし、正規表現（または固定文字列）を検索します。

{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern' [-F] [-T 20] [-i 0.5] [-l 2000]
  • -t/--target ペインの指定（必須）
  • -p/--pattern 一致させる正規表現（必須）。固定文字列の場合は -F を追加
  • -T タイムアウト秒数（整数、デフォルトは 15）
  • -i ポーリング間隔（秒、デフォルトは 0.5）
  • -l 検索する履歴行数（整数、デフォルトは 1000）

コメント

Markdown 対応