# Sizukutamago Dev Tools Plugin Tmux AI Chat

> tmux-ai-chat

- Skill: `tomevault-io/sizukutamago-dev-tools-plugin-tmux-ai-chat` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sizukutamago-dev-tools-plugin-tmux-ai-chat`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sizukutamago-dev-tools-plugin-tmux-ai-chat/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sizukutamago-dev-tools-plugin-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 --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` が使用できます。

```bash
# 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"
```

### ファイル経由で長文送信

```bash
# プロンプトをファイルに保存
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
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/sizukutamago) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-16 -->