tmux完全ガイド：ターミナル多重化で作業効率を上げる

Session: "dev"
├── Window 0: "editor"
│   ├── Pane 0: vim
│   └── Pane 1: file browser
├── Window 1: "server"
│   └── Pane 0: npm run dev
└── Window 2: "test"
    ├── Pane 0: test runner
    └── Pane 1: log tail

tmux -V
# tmux 3.6a

# 名前付きセッションを作成
tmux new -s work

# セッション一覧を表示
tmux ls

# セッションにアタッチ（再接続）
tmux attach -t work
# 短縮形
tmux a -t work

# セッションを終了
tmux kill-session -t work

# -------------------------------------------
# プレフィックスキーを Ctrl+a に変更
# -------------------------------------------
# GNU Screen と同じキー。Ctrl+b より押しやすい
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# -------------------------------------------
# ペイン分割を直感的なキーに変更
# -------------------------------------------
# | で左右分割、- で上下分割。新しいペインは現在のディレクトリを引き継ぐ
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
unbind '"'
unbind %

# -------------------------------------------
# ペイン移動を vim 風にする
# -------------------------------------------
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# -------------------------------------------
# マウス操作を有効にする
# -------------------------------------------
set -g mouse on

# -------------------------------------------
# ウィンドウとペインの番号を 1 から開始
# -------------------------------------------
set -g base-index 1
setw -g pane-base-index 1

# -------------------------------------------
# ウィンドウを閉じたとき番号を詰める
# -------------------------------------------
set -g renumber-windows on

# -------------------------------------------
# 256色サポート
# -------------------------------------------
set -g default-terminal "screen-256color"
set -sa terminal-overrides ",xterm-256color:RGB"

# -------------------------------------------
# コピーモードを vi キーバインドにする
# -------------------------------------------
setw -g mode-keys vi

# -------------------------------------------
# ヒストリの上限を増やす
# -------------------------------------------
set -g history-limit 10000

# -------------------------------------------
# ステータスバーをカスタマイズ
# -------------------------------------------
set -g status-style 'bg=colour235 fg=colour136'
set -g status-left '#[fg=green]#S '
set -g status-right '%Y-%m-%d %H:%M'
set -g status-left-length 20

# ターミナルから
tmux source-file ~/.tmux.conf

# tmux 内のコマンドプロンプトから
# prefix : を押して入力
source-file ~/.tmux.conf

# サーバーに SSH 接続
ssh user@server.example.com

# tmux セッションを作成して作業開始
tmux new -s deploy

# 長時間かかるデプロイを実行
./deploy.sh

# 回線が不安定なら、あえてデタッチしておく
# prefix d

# --- 接続が切れた / 後日戻ってきた ---

# サーバーに再接続
ssh user@server.example.com

# セッションに復帰
tmux a -t deploy
# デプロイ結果がそのまま見える

#!/bin/bash
# dev-tmux.sh — 開発用 tmux セッションを一括起動

SESSION="dev"
PROJECT_DIR="$HOME/projects/myapp"

# 既存セッションがあればアタッチして終了
tmux has-session -t $SESSION 2>/dev/null && {
  tmux attach -t $SESSION
  exit 0
}

# 新規セッション作成（デタッチ状態で）
tmux new-session -d -s $SESSION -c $PROJECT_DIR

# Pane 0: エディタ
tmux send-keys 'vim .' C-m

# 右側にペインを分割: 開発サーバー
tmux split-window -h -c $PROJECT_DIR
tmux send-keys 'npm run dev' C-m

# 右下にペインを分割: テストウォッチャー
tmux split-window -v -c $PROJECT_DIR
tmux send-keys 'npm run test -- --watch' C-m

# 左側のエディタペインにフォーカスを戻す
tmux select-pane -t 0

# セッションにアタッチ
tmux attach -t $SESSION

# 実行権限を付けて使う
chmod +x dev-tmux.sh
./dev-tmux.sh

# 3つのサーバーそれぞれにペインを作成
tmux new -s servers
tmux split-window -h
tmux split-window -v
tmux select-pane -t 0

# 各ペインで SSH 接続
# Pane 0: ssh web1.example.com
# Pane 1: ssh web2.example.com
# Pane 2: ssh web3.example.com

# 全ペイン同期を有効化
# prefix : で入力
setw synchronize-panes on

# 以降の入力が全ペインに同時送信される
# 例: sudo apt update && sudo apt upgrade -y

# 同期を解除
setw synchronize-panes off

# メンバー A がセッションを作成
tmux new -s pair

# メンバー B が同じセッションにアタッチ
tmux attach -t pair

# 両者の入力がリアルタイムに反映される

# ウィンドウを作成したらペインのパスを自動同期
tmux set-hook -g after-new-window 'send-keys "cd #{pane_current_path}" C-m'

# セッション作成時にステータスバーの色を設定
tmux set-hook -g session-created 'set status-style bg=colour235'

# フローティングウィンドウでメモを取る
tmux display-popup -E 'vim ~/notes.md'

# fzf でセッションを切り替える
tmux display-popup -E 'tmux list-sessions -F "#{session_name}" | fzf | xargs tmux switch-client -t'

# prefix + g でセッションスイッチャーを起動
bind g display-popup -E 'tmux list-sessions -F "#{session_name}" | fzf | xargs tmux switch-client -t'

# 現在のペインの内容をファイルに保存
tmux capture-pane -pS - > ~/tmux-output.log

# スクロールバッファ全体をキャプチャ（過去5000行）
tmux capture-pane -pS -5000 > ~/full-log.txt

# 特定のペインにコマンドを送信
tmux send-keys -t dev:0.1 'npm run build' C-m

# 全ペインに同じコマンドを送信（synchronize-panes なしで）
for pane in $(tmux list-panes -F '#{pane_id}'); do
  tmux send-keys -t "$pane" 'echo "pane: $TMUX_PANE"' C-m
done

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# プラグインリスト
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'tmux-plugins/tmux-resurrect'

# TPM を初期化（この行は必ず .tmux.conf の最下部に置く）
run '~/.tmux/plugins/tpm/tpm'