tmux-ai-chat
tmux を使った AI チャット連携の共通基盤スキル。
スクリプト: tmux_ai.sh
場所
skills/tmux-ai-chat/scripts/tmux_ai.sh
サブコマンド
split - ペイン作成
tmux_ai.sh split --direction h --percent 50 --name <title> [--cmd <command>] --print-pane-id
| オプション | 説明 | デフォルト |
|---|---|---|
--direction, -d | 分割方向（h=水平, v=垂直） | h |
--percent, -p | 新ペインのサイズ（%） | 50 |
--name, -n | ペインタイトル | なし |
--cmd, -c | 実行するコマンド | なし |
--print-pane-id | ペインIDを出力 | なし |
出力: --print-pane-id 指定時、新しいペインID（例: %12）
send - テキスト送信
tmux_ai.sh send --pane <id> [--wrap] [--text <str> | --file <path>] --enter
| オプション | 説明 |
|---|---|
--pane | 送信先ペイン（必須） |
--text, -t | 送信するテキスト |
--file, -f | 送信するファイル |
--wrap, -w | マーカーで囲む（シェルプロンプト専用） |
--enter, -e | 最後に Enter を送信 |
出力: --wrap 指定時、マーカーID（例: 20260204T120102-a1b2c3d4）
⚠️ 重要:
--wrapはprintfコマンドを実行してマーカーを出力するため、 ペインがシェルプロンプト（bash等）でないと動作しません。 対話型 AI CLI（codex, gemini 等）では使用できません。
capture - 出力取得
tmux_ai.sh capture --pane <id> --between <marker_id> --wait-ms 30000
| オプション | 説明 | デフォルト |
|---|---|---|
--pane | キャプチャ元ペイン（必須） | |
--between, -b | マーカーID間をキャプチャ | |
--last-lines, -l | 最後のN行をキャプチャ | |
--wait-ms | タイムアウト時間（ミリ秒） | 8000 |
--interval-ms | ポーリング間隔（ミリ秒） | 200 |
出力: キャプチャしたテキスト
kill - ペイン終了
tmux_ai.sh kill --pane <id>
| オプション | 説明 |
|---|---|
--pane | 終了するペイン（必須） |
--force, -f | 現在のペインも強制終了 |
エラーコード
| コード | 意味 | 対応 |
|---|---|---|
| 0 | 成功 | - |
| 64 | 使い方エラー（不正引数） | 引数を確認 |
| 69 | 外部要因（tmux未起動等） | tmux セッション内で実行 |
| 72 | I/Oエラー（ファイル読み込み失敗） | ファイルパスを確認 |
| 124 | タイムアウト | --wait-ms を増やすか、手動確認 |
使用例
対話型 AI CLI との連携（推奨）
対話型 AI CLI（codex, gemini 等）では --wrap は使用せず、--last-lines でキャプチャします。
# 1. ペイン作成（AI CLI を起動）
pane=$(tmux_ai.sh split --direction h --percent 50 --name codex --cmd "codex" --print-pane-id)
# 2. AI CLI の起動を待機
sleep 5
# 3. 質問送信（wrap なし）
tmux_ai.sh send --pane "$pane" --text "設計について相談したい" --enter
# 4. 応答を待機してキャプチャ
sleep 60
response=$(tmux_ai.sh capture --pane "$pane" --last-lines 100)
# 5. ペイン終了
tmux_ai.sh kill --pane "$pane"
シェルコマンド実行（wrap 使用）
シェルプロンプトでワンショットコマンドを実行する場合は --wrap が使用できます。
# 1. シェルペイン作成（コマンドなし）
pane=$(tmux_ai.sh split --direction h --percent 50 --name shell --print-pane-id)
# 2. コマンド実行（マーカー付き）
id=$(tmux_ai.sh send --pane "$pane" --wrap --text "ls -la" --enter)
# 3. 結果をマーカー間から抽出
result=$(tmux_ai.sh capture --pane "$pane" --between "$id" --wait-ms 5000)
# 4. ペイン終了
tmux_ai.sh kill --pane "$pane"
ファイル経由で長文送信
# プロンプトをファイルに保存
cat > /tmp/prompt.txt << 'EOF'
以下のコードをレビューしてください:
```python
def calculate(x, y):
return x + y
EOF
ファイルを送信
id=$(tmux_ai.sh send --pane "$pane" --wrap --file /tmp/prompt.txt --enter)
### タイムアウト処理
```bash
if ! response=$(tmux_ai.sh capture --pane "$pane" --between "$id" --wait-ms 60000); then
case $? in
124)
echo "タイムアウト: 追加で待機するか、手動で確認してください"
# フォールバック: 最後の100行を取得
tmux_ai.sh capture --pane "$pane" --last-lines 100
;;
*)
echo "エラーが発生しました"
;;
esac
fi