インタラクティブコマンドに対する tmux の使用

概要

インタラクティブな CLI ツール (vim、インタラクティブな git rebase、REPL など) は、実際のターミナルが必要なため、標準的な bash では制御できません。tmux は、send-keys と capture-pane を通じてプログラム的に制御できるデタッチセッションを提供します。

使用時機

tmux を使用する場合:

• vim、nano などのテキストエディタをプログラム的に実行する
• インタラクティブな REPL (Python、Node など) を制御する
• インタラクティブな git コマンド (git rebase -i、git add -p) を処理する
• フルスクリーンターミナルアプリ (htop など) と連携する
• ターミナル制御コードや readline が必要なコマンド

使用しない場合:

• シンプルな非インタラクティブコマンド (通常の Bash ツールを使用)
• stdin リダイレクション経由で入力を受け付けるコマンド
• インタラクションが必要ない 1 回限りのコマンド

クイックリファレンス

タスク	コマンド
セッション開始	tmux new-session -d -s <name> <command>
入力送信	tmux send-keys -t <name> 'text' Enter
出力キャプチャ	tmux capture-pane -t <name> -p
セッション停止	tmux kill-session -t <name>
セッション一覧	tmux list-sessions

コアパターン

以前 (動作しない)

# vim がインタラクティブターミナルを期待するため、ここでハングします
bash -c "vim file.txt"

現在 (動作する)

# デタッチされた tmux セッションを作成
tmux new-session -d -s edit_session vim file.txt

# コマンドを送信 (Enter、Escape は tmux のキー名)
tmux send-keys -t edit_session 'i' 'Hello World' Escape ':wq' Enter

# 画面上の内容をキャプチャ
tmux capture-pane -t edit_session -p

# クリーンアップ
tmux kill-session -t edit_session

実装

基本的なワークフロー

1. デタッチセッションを作成 する (インタラクティブコマンドを含む)
2. 初期化を待つ (100～500ms、コマンドによる)
3. 入力を送信 する (send-keys を使用。Enter、Escape などの特殊キーも送信可能)
4. 出力をキャプチャ する (capture-pane -p を使用して現在の画面状態を確認)
5. ステップ 3～4 を繰り返す (必要に応じて)
6. セッションを終了 する (完了時)

特殊キー

一般的な tmux キー名:

• Enter - Return/改行
• Escape - ESC キー
• C-c - Ctrl+C
• C-x - Ctrl+X
• Up、Down、Left、Right - 矢印キー
• Space - スペースキー
• BSpace - バックスペース

作業ディレクトリ

セッション作成時に作業ディレクトリを指定:

tmux new-session -d -s git_session -c /path/to/repo git rebase -i HEAD~3

ヘルパーラッパー

使いやすくするために、/home/jesse/git/interactive-command/tmux-wrapper.sh を参照:

# セッション開始
/path/to/tmux-wrapper.sh start <session-name> <command> [args...]

# 入力送信
/path/to/tmux-wrapper.sh send <session-name> 'text' Enter

# 現在の状態をキャプチャ
/path/to/tmux-wrapper.sh capture <session-name>

# 停止
/path/to/tmux-wrapper.sh stop <session-name>

一般的なパターン

Python REPL

tmux new-session -d -s python python3 -i
tmux send-keys -t python 'import math' Enter
tmux send-keys -t python 'print(math.pi)' Enter
tmux capture-pane -t python -p  # 出力を確認
tmux kill-session -t python

Vim による編集

tmux new-session -d -s vim vim /tmp/file.txt
sleep 0.3  # vim の開始を待つ
tmux send-keys -t vim 'i' 'New content' Escape ':wq' Enter
# ファイルは保存されています

インタラクティブな Git リベース

tmux new-session -d -s rebase -c /repo/path git rebase -i HEAD~3
sleep 0.5
tmux capture-pane -t rebase -p  # リベースエディタを確認
# リベース指示を変更するコマンドを送信
tmux send-keys -t rebase 'Down' 'Home' 'squash' Escape
tmux send-keys -t rebase ':wq' Enter

よくある間違い

セッション開始後に待機しない

問題: new-session の直後にキャプチャすると、空白の画面が表示される

解決策: 最初のキャプチャ前に短い sleep を追加 (100～500ms)

tmux new-session -d -s sess command
sleep 0.3  # コマンドを初期化させる
tmux capture-pane -t sess -p

Enter キーを忘れる

問題: コマンドが入力されるが実行されない

解決策: 明示的に Enter を送信

tmux send-keys -t sess 'print("hello")' Enter  # 注: Enter は別の引数

間違ったキー名を使用する

問題: tmux send-keys -t sess '\n' は動作しない

解決策: tmux キー名を使用: \n ではなく Enter

tmux send-keys -t sess 'text' Enter  # ✓
tmux send-keys -t sess 'text\n'      # ✗

セッションをクリーンアップしない

問題: 孤立した tmux セッションが蓄積される

解決策: 完了時に常にセッションを終了

tmux kill-session -t session_name
# または存在確認: tmux has-session -t name 2>/dev/null

実際の効果

• vim/nano のプログラム的な制御によるファイル編集を実現
• インタラクティブな git ワークフロー (リベース、add -p) の自動化を可能にする
• REPL ベースのテスト/デバッグを可能にする
• ターミナルインタラクションが必要なツールのブロックを解除
• カスタム PTY 管理を構築する必要がない - tmux がすべてを処理