tmux-ai-chat

# tmux-ai-chat

tmux を使った AI チャット連携の共通基盤スキル。

## スクリプト: tmux_ai.sh

### 場所

```
skills/tmux-ai-chat/scripts/tmux_ai.sh
```

### サブコマンド

#### split - ペイン作成

```bash
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 - テキスト送信

```bash
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 - 出力取得

```bash
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 - ペイン終了

```bash
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` でキャプチャします。

```bash
# 1. ペイン作成（AI CLI を起動）
pane=$(tmux_ai.sh split --direction h --per