Tmux 명령어 완벽 가이드: 터미널 멀티플렉서로 생산성을 10배 높이는 모든 명령어 총정리

# Ubuntu / Debian
sudo apt update && sudo apt install -y tmux

# CentOS / RHEL / Rocky Linux
sudo yum install -y tmux
# 또는
sudo dnf install -y tmux

# macOS (Homebrew)
brew install tmux

# Arch Linux
sudo pacman -S tmux

# 소스 빌드 (최신 버전이 필요한 경우)
git clone https://github.com/tmux/tmux.git
cd tmux
sh autogen.sh
./configure && make
sudo make install

tmux -V
# tmux 3.5a

Tmux Server (백그라운드 프로세스)
  └── Session (세션: 논리적 작업 단위)
        ├── Window 0 (윈도우: 탭과 유사)
        │     ├── Pane 0 (페인: 분할된 영역)
        │     ├── Pane 1
        │     └── Pane 2
        ├── Window 1
        │     ├── Pane 0
        │     └── Pane 1
        └── Window 2
              └── Pane 0

# 기본 세션 생성 (이름 자동 지정: 0, 1, 2, ...)
tmux

# 이름을 지정하여 세션 생성
tmux new -s dev

# 이름을 지정하고 특정 디렉토리에서 시작
tmux new -s project -c ~/workspace/my-project

# 세션 생성 후 바로 명령어 실행
tmux new -s monitoring 'htop'

# 세션 생성하되 attach하지 않음 (백그라운드)
tmux new -s background -d

# 윈도우 이름까지 지정하여 생성
tmux new -s dev -n editor

# 세션 목록 조회
tmux ls
# 또는
tmux list-sessions

# 출력 예시:
# dev: 3 windows (created Mon Mar  1 10:00:00 2026)
# monitoring: 1 windows (created Mon Mar  1 10:05:00 2026)
# background: 2 windows (created Mon Mar  1 10:10:00 2026) (attached)

<prefix> s    # 세션 목록을 인터랙티브하게 보여준다

# 마지막으로 사용한 세션에 attach
tmux attach
# 또는
tmux a

# 특정 세션에 attach
tmux attach -t dev
# 또는
tmux a -t dev

# 다른 클라이언트가 접속 중이어도 강제 attach (기존 클라이언트 detach)
tmux attach -dt dev

<prefix> d    # 현재 세션에서 detach

# 특정 클라이언트를 detach (외부에서)
tmux detach-client -t dev

<prefix> $    # 현재 세션 이름 변경 (프롬프트가 나타남)

# 외부에서 세션 이름 변경
tmux rename-session -t old_name new_name

<prefix> s    # 세션 목록에서 선택하여 전환
<prefix> (    # 이전 세션으로 전환
<prefix> )    # 다음 세션으로 전환

# 외부에서 특정 세션으로 전환 (이미 attach 상태일 때)
tmux switch-client -t monitoring

# 특정 세션 종료
tmux kill-session -t dev

# 현재 세션을 제외한 모든 세션 종료
tmux kill-session -a

# 특정 세션을 제외한 모든 세션 종료
tmux kill-session -a -t dev

# Tmux 서버 전체 종료 (모든 세션 종료)
tmux kill-server

# 세션 내에서 exit 또는 Ctrl-d로 마지막 윈도우/페인을 닫으면 세션도 종료
exit

# 세션이 존재하면 attach, 없으면 생성하는 패턴
tmux new -A -s dev

# 이것은 아래와 동일한 동작이다:
# tmux has-session -t dev 2>/dev/null && tmux attach -t dev || tmux new -s dev

<prefix> c    # 새 윈도우 생성

# 명령줄에서 윈도우 생성
tmux new-window

# 이름을 지정하여 윈도우 생성
tmux new-window -n logs

# 특정 디렉토리에서 윈도우 생성
tmux new-window -c ~/workspace/logs -n logs

# 특정 위치(인덱스)에 윈도우 생성
tmux new-window -t 3

<prefix> ,    # 현재 윈도우 이름 변경 (프롬프트가 나타남)

# 명령줄에서 윈도우 이름 변경
tmux rename-window -t 0 editor

<prefix> 0~9  # 윈도우 번호로 직접 이동 (0번~9번)
<prefix> n    # 다음(next) 윈도우로 이동
<prefix> p    # 이전(previous) 윈도우로 이동
<prefix> l    # 마지막으로 사용한 윈도우로 토글
<prefix> w    # 윈도우 목록에서 인터랙티브하게 선택
<prefix> '    # 윈도우 인덱스를 입력하여 이동 (10번 이상일 때 유용)
<prefix> f    # 윈도우 이름으로 검색하여 이동

# 윈도우 순서 변경 (현재 윈도우를 3번 위치로)
tmux move-window -t 3

# 윈도우를 다른 세션으로 이동
tmux move-window -t other_session:

# 윈도우를 다른 세션의 특정 위치로 이동
tmux move-window -t other_session:2

# 현재 윈도우와 특정 윈도우의 위치 교환
tmux swap-window -t 0

# 윈도우 번호 재정렬 (빈 번호 제거)
tmux move-window -r

<prefix> &    # 현재 윈도우 닫기 (확인 프롬프트 표시)

# 명령줄에서 특정 윈도우 닫기
tmux kill-window -t 2

# 현재 윈도우를 제외한 모든 윈도우 닫기
tmux kill-window -a

# 모든 세션의 윈도우 목록
tmux list-windows -a

# 특정 세션의 윈도우 목록
tmux list-windows -t dev

<prefix> %    # 수직 분할 (좌우로 나눔, vertical split)
<prefix> "    # 수평 분할 (상하로 나눔, horizontal split)

# 명령줄에서 페인 분할
tmux split-window          # 수평 분할
tmux split-window -h       # 수직 분할

# 특정 디렉토리에서 분할
tmux split-window -h -c ~/workspace

# 특정 크기로 분할 (전체의 30%)
tmux split-window -p 30
tmux split-window -h -p 40

# 특정 행/열 수로 분할
tmux split-window -l 10      # 10행 높이
tmux split-window -h -l 40   # 40열 너비

# 명령어를 실행하며 분할
tmux split-window 'tail -f /var/log/syslog'

<prefix> 방향키(↑↓←→)    # 방향키로 페인 이동
<prefix> o               # 다음 페인으로 순환 이동
<prefix> ;               # 마지막으로 활성화된 페인으로 토글
<prefix> q               # 페인 번호 표시 (번호를 누르면 해당 페인으로 이동)

<prefix> Ctrl-방향키      # 1칸씩 크기 조절
<prefix> Alt-방향키       # 5칸씩 크기 조절

# 명령줄에서 크기 조절
tmux resize-pane -D 5     # 아래로 5칸 확장
tmux resize-pane -U 5     # 위로 5칸 확장
tmux resize-pane -L 10    # 왼쪽으로 10칸 확장
tmux resize-pane -R 10    # 오른쪽으로 10칸 확장

<prefix> z    # 현재 페인 줌 토글 (전체 화면 <-> 원래 크기)

<prefix> {    # 현재 페인을 이전 위치로 이동
<prefix> }    # 현재 페인을 다음 위치로 이동
<prefix> Ctrl-o  # 모든 페인을 시계 반대 방향으로 회전
<prefix> Alt-o   # 모든 페인을 시계 방향으로 회전

# 특정 페인끼리 위치 교환
tmux swap-pane -s 0 -t 1

# 페인을 다른 윈도우로 이동 (join)
tmux join-pane -t :1          # 현재 페인을 윈도우 1로 이동
tmux join-pane -s :2 -t :1    # 윈도우 2의 페인을 윈도우 1로 이동

# 페인을 독립된 윈도우로 분리 (break)
<prefix> !    # 현재 페인을 새 윈도우로 분리

# 명령줄로 페인을 새 윈도우로 분리
tmux break-pane
tmux break-pane -t 1    # 1번 페인을 새 윈도우로

<prefix> Space    # 다음 레이아웃으로 순환 전환
<prefix> Alt-1    # even-horizontal (모든 페인을 수평으로 균등 배치)
<prefix> Alt-2    # even-vertical (모든 페인을 수직으로 균등 배치)
<prefix> Alt-3    # main-horizontal (메인 페인 상단, 나머지 하단 분할)
<prefix> Alt-4    # main-vertical (메인 페인 좌측, 나머지 우측 분할)
<prefix> Alt-5    # tiled (타일 형태로 균등 배치)

even-horizontal          even-vertical
┌──────┬──────┬──────┐   ┌──────────────────┐
│      │      │      │   │     Pane 0       │
│ P0   │ P1   │ P2   │   ├──────────────────┤
│      │      │      │   │     Pane 1       │
│      │      │      │   ├──────────────────┤
└──────┴──────┴──────┘   │     Pane 2       │
                         └──────────────────┘

main-horizontal          main-vertical
┌──────────────────┐     ┌──────────┬───────┐
│     Pane 0       │     │          │ P1    │
│    (main)        │     │  Pane 0  ├───────┤
├────────┬─────────┤     │  (main)  │ P2    │
│  P1    │   P2    │     │          ├───────┤
└────────┴─────────┘     │          │ P3    │
                         └──────────┴───────┘

tiled
┌─────────┬─────────┐
│  P0     │  P1     │
├─────────┼─────────┤
│  P2     │  P3     │
└─────────┴─────────┘

<prefix> x    # 현재 페인 닫기 (확인 프롬프트 표시)

# 명령줄에서 페인 닫기
tmux kill-pane
tmux kill-pane -t 2    # 2번 페인 닫기

# 현재 페인을 제외한 모든 페인 닫기
tmux kill-pane -a

# 페인을 마크 (표시)
<prefix> m    # 현재 페인에 마크 토글

# 마크된 페인과 현재 페인 교환
tmux swap-pane

<prefix> [    # 복사 모드 진입
q             # 복사 모드 종료 (또는 Esc)

# .tmux.conf에서 Vi 모드 설정 (강력 추천)
setw -g mode-keys vi

/검색어     # 아래 방향으로 검색 (Vi 모드)
?검색어     # 위 방향으로 검색 (Vi 모드)
n           # 다음 검색 결과로 이동
N           # 이전 검색 결과로 이동

Ctrl-s      # 아래 방향으로 증분 검색
Ctrl-r      # 위 방향으로 증분 검색

1. <prefix> [          # 복사 모드 진입
2. 이동 키로 시작점 이동
3. Space              # 선택 시작
4. 이동 키로 끝점 이동
5. Enter              # 선택 영역 복사 (tmux buffer에 저장)

# Vi 스타일로 복사/붙여넣기 바인딩 추가 (.tmux.conf)
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi y send-keys -X copy-selection-and-cancel
bind -T copy-mode-vi r send-keys -X rectangle-toggle

<prefix> ]    # tmux buffer의 내용을 붙여넣기

# 버퍼 목록 확인
tmux list-buffers

# 특정 버퍼 내용 확인
tmux show-buffer -b 0

# 버퍼를 파일로 저장
tmux save-buffer -b 0 ~/buffer.txt

# 파일 내용을 버퍼에 로드
tmux load-buffer ~/content.txt

# 버퍼 삭제
tmux delete-buffer -b 0

# .tmux.conf
set -g history-limit 50000

# .tmux.conf - Ctrl-a로 변경 (GNU Screen 스타일)
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# Ctrl-Space로 변경 (추천)
unbind C-b
set -g prefix C-Space
bind C-Space send-prefix

# 기본 문법
bind-key [옵션] 키 명령어
# 축약형
bind 키 명령어

# Prefix 없이 바인딩 (-n 플래그)
bind -n M-Left select-pane -L     # Alt-Left로 왼쪽 페인 이동
bind -n M-Right select-pane -R    # Alt-Right로 오른쪽 페인 이동
bind -n M-Up select-pane -U       # Alt-Up으로 위쪽 페인 이동
bind -n M-Down select-pane -D     # Alt-Down으로 아래쪽 페인 이동

# 반복 가능한 바인딩 (-r 플래그)
bind -r h resize-pane -L 5
bind -r j resize-pane -D 5
bind -r k resize-pane -U 5
bind -r l resize-pane -R 5

# 분할 시 현재 경로 유지
bind '"' split-window -v -c "#{pane_current_path}"
bind '%' split-window -h -c "#{pane_current_path}"
bind c new-window -c "#{pane_current_path}"

# 특정 키 바인딩 해제
unbind-key C-b
# 축약형
unbind C-b

# 모든 키 바인딩 해제 (주의해서 사용)
unbind -a

<prefix> ?    # 모든 키 바인딩 목록 표시

# 명령줄에서 확인
tmux list-keys
tmux list-keys | grep split    # 특정 명령어 필터링

# 설정 파일 즉시 리로드
bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"

# 더 직관적인 분할 키
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# 윈도우 재정렬
bind R move-window -r \; display-message "Windows renumbered!"

# 동기화 모드 토글 (모든 페인에 동시 입력)
bind S setw synchronize-panes \; display-message "Sync #{?synchronize-panes,ON,OFF}"

# 세션 선택 단축키
bind C-s choose-session

# 팝업 윈도우로 lazygit 실행 (tmux 3.2+)
bind g display-popup -E -w 80% -h 80% "lazygit"

# 팝업 윈도우로 htop 실행
bind t display-popup -E -w 80% -h 80% "htop"

# ~/.tmux.conf

# ─────────────────────────────────────────────
# 기본 설정
# ─────────────────────────────────────────────

# Prefix를 Ctrl-a로 변경
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# 인덱스를 1부터 시작 (0번 키가 키보드 우측 끝에 있어 불편)
set -g base-index 1
setw -g pane-base-index 1

# 윈도우 닫을 때 번호 재정렬
set -g renumber-windows on

# 히스토리 크기
set -g history-limit 50000

# 이스케이프 시간 단축 (Vim 사용자를 위해)
set -sg escape-time 0

# 반복 키 입력 대기 시간
set -g repeat-time 600

# 포커스 이벤트 활성화 (Vim/Neovim 연동)
set -g focus-events on

# 설정 리로드
bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"

# 마우스 지원 활성화 (tmux 2.1+)
set -g mouse on

# 마우스로 가능한 것들:
# - 페인 클릭으로 포커스 전환
# - 페인 경계 드래그로 크기 조절
# - 스크롤 휠로 히스토리 탐색
# - 텍스트 드래그로 복사 모드 진입 및 선택

# 복사 모드에서 Vi 키바인딩 사용
setw -g mode-keys vi

# Vi 스타일 복사
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi V send-keys -X select-line
bind -T copy-mode-vi y send-keys -X copy-selection-and-cancel
bind -T copy-mode-vi r send-keys -X rectangle-toggle
bind -T copy-mode-vi Escape send-keys -X cancel

# 상태줄 명령어에서 Vi 모드
set -g status-keys vi

# ─────────────────────────────────────────────
# 상태바 설정
# ─────────────────────────────────────────────

# 상태바 위치 (top 또는 bottom)
set -g status-position bottom

# 상태바 갱신 주기 (초)
set -g status-interval 5

# 상태바 색상
set -g status-style 'bg=#1e1e2e,fg=#cdd6f4'

# 좌측 상태바
set -g status-left-length 50
set -g status-left '#[fg=#1e1e2e,bg=#89b4fa,bold] #S #[fg=#89b4fa,bg=#1e1e2e] '

# 우측 상태바
set -g status-right-length 100
set -g status-right '#[fg=#585b70]│ #[fg=#cdd6f4]%Y-%m-%d #[fg=#585b70]│ #[fg=#cdd6f4]%H:%M #[fg=#89b4fa,bg=#1e1e2e]#[fg=#1e1e2e,bg=#89b4fa,bold] #H '

# 현재 윈도우 스타일
setw -g window-status-current-format '#[fg=#1e1e2e,bg=#a6e3a1,bold] #I:#W#{?window_zoomed_flag, Z,} '

# 비활성 윈도우 스타일
setw -g window-status-format '#[fg=#585b70] #I:#W '

# 윈도우 목록 정렬
set -g status-justify left

┌──────────────────────────────────────────────────────────────┐
│ dev  1:editor  2:server  3:logs                  2026-03-01 │
│                                                    14:30    │
└──────────────────────────────────────────────────────────────┘

# 256 color 지원
set -g default-terminal "screen-256color"

# True Color (24-bit) 지원
set -ga terminal-overrides ",xterm-256color:Tc"
# 또는 alacritty 사용 시
set -ga terminal-overrides ",alacritty:Tc"

# 페인 테두리 색상
set -g pane-border-style 'fg=#585b70'
set -g pane-active-border-style 'fg=#89b4fa'

# 메시지 스타일
set -g message-style 'fg=#cdd6f4,bg=#1e1e2e,bold'

# 복사 모드 하이라이트 색상
setw -g mode-style 'fg=#1e1e2e,bg=#f5c2e7,bold'

# macOS (pbcopy/pbpaste)
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
bind -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "pbcopy"

# Linux (xclip)
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -in -selection clipboard"
bind -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "xclip -in -selection clipboard"

# Linux (xsel)
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xsel --clipboard --input"

# Linux (wl-copy, Wayland)
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "wl-copy"

# 크로스 플랫폼 자동 감지
if-shell "uname | grep -q Darwin" {
    bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
} {
    bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -in -selection clipboard"
}

# ═══════════════════════════════════════════════════════════════
# ~/.tmux.conf - 실전 최적화 설정
# ═══════════════════════════════════════════════════════════════

# ─── Prefix ───────────────────────────────────────────────────
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# ─── 기본 설정 ────────────────────────────────────────────────
set -g base-index 1
setw -g pane-base-index 1
set -g renumber-windows on
set -g history-limit 50000
set -sg escape-time 0
set -g repeat-time 600
set -g focus-events on
set -g mouse on
setw -g mode-keys vi
set -g status-keys vi

# ─── 색상 ─────────────────────────────────────────────────────
set -g default-terminal "screen-256color"
set -ga terminal-overrides ",xterm-256color:Tc"

# ─── 키바인딩 ─────────────────────────────────────────────────
# 설정 리로드
bind r source-file ~/.tmux.conf \; display "Reloaded!"

# 직관적 분할 (현재 경로 유지)
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
bind c new-window -c "#{pane_current_path}"
unbind '"'
unbind %

# Vi 스타일 페인 이동
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# 페인 리사이즈
bind -r H resize-pane -L 5
bind -r J resize-pane -D 5
bind -r K resize-pane -U 5
bind -r L resize-pane -R 5

# Alt + 방향키로 prefix 없이 페인 이동
bind -n M-Left select-pane -L
bind -n M-Right select-pane -R
bind -n M-Up select-pane -U
bind -n M-Down select-pane -D

# Shift + 방향키로 윈도우 전환
bind -n S-Left previous-window
bind -n S-Right next-window

# 동기화 토글
bind S setw synchronize-panes \; display "Sync #{?synchronize-panes,ON,OFF}"

# ─── 복사 모드 ────────────────────────────────────────────────
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi V send-keys -X select-line
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
bind -T copy-mode-vi r send-keys -X rectangle-toggle

# ─── 상태바 ───────────────────────────────────────────────────
set -g status-position bottom
set -g status-interval 5
set -g status-style 'bg=#1e1e2e,fg=#cdd6f4'
set -g status-left-length 50
set -g status-left '#[fg=#1e1e2e,bg=#89b4fa,bold] #S #[default] '
set -g status-right '#[fg=#cdd6f4]%Y-%m-%d %H:%M #[fg=#1e1e2e,bg=#89b4fa,bold] #H '
setw -g window-status-current-format '#[fg=#1e1e2e,bg=#a6e3a1,bold] #I:#W#{?window_zoomed_flag, Z,} '
setw -g window-status-format '#[fg=#585b70] #I:#W '

# ─── 페인 테두리 ──────────────────────────────────────────────
set -g pane-border-style 'fg=#585b70'
set -g pane-active-border-style 'fg=#89b4fa'

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'
set -g @plugin 'tmux-plugins/tmux-continuum'
set -g @plugin 'tmux-plugins/tmux-yank'

# TPM 초기화 (반드시 .tmux.conf 맨 마지막에 위치)
run '~/.tmux/plugins/tpm/tpm'

<prefix> I        # 플러그인 설치 (Install)
<prefix> U        # 플러그인 업데이트 (Update)
<prefix> Alt-u    # 사용하지 않는 플러그인 제거 (Uninstall)

set -g @plugin 'tmux-plugins/tmux-sensible'

set -g @plugin 'tmux-plugins/tmux-resurrect'

# Vim 세션 복원 (선택)
set -g @resurrect-strategy-vim 'session'
# Neovim 세션 복원 (선택)
set -g @resurrect-strategy-nvim 'session'
# 페인 내용 복원
set -g @resurrect-capture-pane-contents 'on'

<prefix> Ctrl-s    # 세션 저장 (Save)
<prefix> Ctrl-r    # 세션 복원 (Restore)

set -g @plugin 'tmux-plugins/tmux-continuum'

# 15분마다 자동 저장
set -g @continuum-save-interval '15'

# Tmux 서버 시작 시 자동 복원
set -g @continuum-restore 'on'

# 시스템 부팅 시 Tmux 자동 시작 (macOS)
set -g @continuum-boot 'on'
set -g @continuum-boot-options 'iterm'

set -g @plugin 'tmux-plugins/tmux-yank'

# 복사 후 복사 모드 유지 (기본값은 종료)
set -g @yank_action 'copy-pipe'

# 현재 페인에 명령어 전송
tmux send-keys "ls -la" Enter

# 특정 세션의 특정 윈도우, 특정 페인에 전송
tmux send-keys -t dev:1.0 "npm start" Enter

# Ctrl-c 전송 (실행 중인 프로세스 중단)
tmux send-keys -t dev:1.0 C-c

# 여러 키 연속 전송
tmux send-keys -t dev:1.0 "cd ~/project" Enter "git status" Enter

세션:윈도우.페인
dev:1.0         # dev 세션, 1번 윈도우, 0번 페인
:2.1            # 현재 세션, 2번 윈도우, 1번 페인
monitoring:     # monitoring 세션, 현재 윈도우

#!/bin/bash
# dev-env.sh - 개발 환경 자동 구성 스크립트

SESSION="dev"
PROJECT_DIR="$HOME/workspace/my-project"

# 기존 세션이 있으면 종료
tmux kill-session -t $SESSION 2>/dev/null

# 새 세션 생성 (detached 모드, 첫 번째 윈도우 이름: editor)
tmux new-session -d -s $SESSION -n editor -c $PROJECT_DIR

# editor 윈도우에서 Neovim 실행
tmux send-keys -t $SESSION:editor "nvim ." Enter

# server 윈도우 생성
tmux new-window -t $SESSION -n server -c $PROJECT_DIR
tmux send-keys -t $SESSION:server "npm run dev" Enter

# logs 윈도우 생성 (수평 분할)
tmux new-window -t $SESSION -n logs -c $PROJECT_DIR
tmux send-keys -t $SESSION:logs "tail -f logs/app.log" Enter
tmux split-window -v -t $SESSION:logs -c $PROJECT_DIR
tmux send-keys -t $SESSION:logs.1 "tail -f logs/error.log" Enter

# test 윈도우 생성
tmux new-window -t $SESSION -n test -c $PROJECT_DIR
tmux send-keys -t $SESSION:test "npm test -- --watch" Enter

# git 윈도우 생성
tmux new-window -t $SESSION -n git -c $PROJECT_DIR
tmux send-keys -t $SESSION:git "git status" Enter

# 첫 번째 윈도우로 이동
tmux select-window -t $SESSION:editor

# 세션에 attach
tmux attach -t $SESSION

# Ruby gem으로 설치
gem install tmuxinator

# macOS
brew install tmuxinator

tmuxinator new my-project

name: my-project
root: ~/workspace/my-project

windows:
  - editor:
      layout: main-vertical
      panes:
        - nvim .
        -  # 빈 셸

  - server:
      panes:
        - npm run dev

  - logs:
      layout: even-vertical
      panes:
        - tail -f logs/app.log
        - tail -f logs/error.log
        - tail -f logs/access.log

  - database:
      panes:
        - docker compose up -d db && sleep 2 && psql -h localhost -U app

  - test:
      panes:
        - npm test -- --watch

# 프로젝트 시작
tmuxinator start my-project
# 축약형
mux my-project

# 프로젝트 중지
tmuxinator stop my-project

# 설정 편집
tmuxinator edit my-project

# 프로젝트 목록
tmuxinator list

# 프로젝트 삭제
tmuxinator delete my-project

# 설치
pip install tmuxp

session_name: dev
start_directory: ~/workspace/my-project
windows:
  - window_name: code
    layout: main-vertical
    panes:
      - shell_command:
          - nvim .
      - shell_command:
          - git status
  - window_name: server
    panes:
      - npm run dev
  - window_name: monitoring
    layout: even-vertical
    panes:
      - htop
      - tail -f /var/log/syslog

# 세션 로드
tmuxp load dev.yaml
tmuxp load ~/.config/tmuxp/dev.yaml

# 현재 세션을 YAML로 내보내기 (freeze)
tmuxp freeze my-session

# 세션 존재 여부 확인 후 조건부 실행
tmux has-session -t dev 2>/dev/null && \
    tmux attach -t dev || \
    tmux new -s dev

# .tmux.conf에서 조건부 설정
if-shell "uname | grep -q Darwin" \
    "set -g default-command 'reattach-to-user-namespace -l zsh'" \
    ""

# Tmux 버전별 조건부 설정
if-shell '[ "$(tmux -V | cut -d" " -f2 | tr -d "a-z")" -ge 32 ]' \
    "set -g popup-style 'bg=#1e1e2e'" \
    ""

# 기본 팝업 (종료 시 자동 닫힘)
tmux display-popup

# 크기와 위치 지정
tmux display-popup -w 80% -h 60% -x C -y C

# 명령어 실행 팝업
tmux display-popup -E "htop"
tmux display-popup -E -w 90% -h 90% "lazygit"

# fzf로 세션 선택 팝업
tmux display-popup -E "tmux list-sessions | fzf | cut -d: -f1 | xargs tmux switch-client -t"

# 키바인딩으로 팝업 등록
bind g display-popup -E -w 80% -h 80% "lazygit"
bind f display-popup -E -w 60% -h 60% "fzf --preview 'cat {}' | xargs nvim"

# 1. 원격 서버 접속
ssh user@remote-server

# 2. Tmux 세션 시작
tmux new -s work

# 3. 작업 수행 (빌드, 배포, 모니터링 등)
make build && make deploy

# 4. SSH 연결 끊김 또는 의도적 detach
# <prefix> d 또는 네트워크 끊김

# 5. 재접속 후 세션 복귀
ssh user@remote-server
tmux attach -t work
# 모든 작업이 그대로 유지되어 있다!

# 데이터 마이그레이션 등 장시간 작업 시작
ssh user@db-server
tmux new -s migration
python migrate_data.py --source prod --target staging

# detach하고 퇴근 (<prefix> d)
# 다음 날 출근 후:
ssh user@db-server
tmux attach -t migration
# 마이그레이션 진행 상태 확인

┌─────────────────────────────────────────┐
│ Window: editor                          │
│ ┌──────────────────────┬──────────────┐ │
│ │                      │ $ npm run dev│ │
│ │    nvim main.ts      │ > Server on  │ │
│ │                      │   port 3000  │ │
│ │                      ├──────────────┤ │
│ │                      │ $ npm test   │ │
│ │                      │ PASS: 42/42  │ │
│ └──────────────────────┴──────────────┘ │
└─────────────────────────────────────────┘

#!/bin/bash
# setup-dev.sh

SESSION="dev"
tmux new-session -d -s $SESSION -n code -c ~/project

# 메인 편집기 (좌측 70%)
tmux send-keys -t $SESSION:code "nvim ." Enter

# 우측 상단: 개발 서버 (우측 30%)
tmux split-window -h -p 30 -t $SESSION:code -c ~/project
tmux send-keys "npm run dev" Enter

# 우측 하단: 테스트 러너
tmux split-window -v -p 50 -t $SESSION:code.1 -c ~/project
tmux send-keys "npm test -- --watch" Enter

# 좌측 페인(편집기)에 포커스
tmux select-pane -t $SESSION:code.0

tmux attach -t $SESSION

# 개발자 A: 세션 생성
tmux new -s pair

# 개발자 B: 같은 서버에 SSH 접속 후 세션에 attach
tmux attach -t pair

# 두 개발자가 같은 화면을 실시간으로 공유

# 개발자 A: 세션 생성
tmux new -s pair

# 개발자 B: 같은 세션에 attach하되 독립적으로 윈도우 전환 가능
tmux new -t pair -s pair-b

# tmate 설치
brew install tmate    # macOS
sudo apt install tmate  # Ubuntu

# tmate 세션 시작
tmate

# 접속 URL이 표시됨
# SSH: ssh xxxxx@lon1.tmate.io
# Web: https://tmate.io/t/xxxxx

# 상대방에게 URL을 공유하면 즉시 세션 공유 가능

#!/bin/bash
# monitoring-dashboard.sh

SESSION="monitor"
tmux new-session -d -s $SESSION -n dashboard

# 4분할 레이아웃
# 좌상: 시스템 리소스
tmux send-keys "htop" Enter

# 우상: 어플리케이션 로그
tmux split-window -h -p 50
tmux send-keys "tail -f /var/log/app/production.log | jq ." Enter

# 좌하: 네트워크 트래픽
tmux split-window -v -p 50 -t 0
tmux send-keys "watch -n 1 'ss -tuln'" Enter

# 우하: 디스크 & 도커 상태
tmux split-window -v -p 50 -t 2
tmux send-keys "watch -n 5 'df -h && echo --- && docker ps --format \"table {{.Names}}\t{{.Status}}\t{{.Ports}}\"'" Enter

tmux attach -t $SESSION

# 동기화 모드 활성화/비활성화
<prefix> :setw synchronize-panes on
<prefix> :setw synchronize-panes off

# 또는 커스텀 바인딩 사용 (8장에서 설정한 경우)
<prefix> S

#!/bin/bash
# multi-server.sh - 여러 서버에 동시 접속

SESSION="multi"
SERVERS=("web1" "web2" "web3" "db1")

tmux new-session -d -s $SESSION

# 첫 번째 서버
tmux send-keys "ssh ${SERVERS[0]}" Enter

# 나머지 서버들을 분할하여 접속
for ((i=1; i<${#SERVERS[@]}; i++)); do
    tmux split-window -t $SESSION
    tmux send-keys "ssh ${SERVERS[$i]}" Enter
    tmux select-layout tiled    # 균등 배치
done

# 동기화 활성화
tmux setw -t $SESSION synchronize-panes on

tmux attach -t $SESSION
# 이제 입력하는 모든 명령어가 4개 서버에 동시 실행된다!

# 문제: Vim/Neovim의 색상이 Tmux 내에서 깨짐

# 해결: .tmux.conf에 다음 추가
set -g default-terminal "screen-256color"
set -ga terminal-overrides ",*256col*:Tc"

# 확인: Tmux 내에서 다음 명령어 실행
tput colors
# 256이 출력되어야 한다

# TERM 환경변수 확인
echo $TERM
# screen-256color 또는 tmux-256color여야 한다

# 문제: Tmux 내에서 Neovim의 ESC 반응이 느림

# 원인: Tmux가 ESC 키 입력 후 다른 키 조합인지 확인하기 위해 대기

# 해결: .tmux.conf에 다음 추가
set -sg escape-time 0
# 또는 최소값으로 설정
set -sg escape-time 10

# 문제: 마우스 휠로 스크롤이 안 됨

# 해결 1: 마우스 지원 활성화
set -g mouse on

# 해결 2: Tmux 2.1 이전 버전이라면 (레거시 문법)
set -g mode-mouse on
set -g mouse-select-pane on
set -g mouse-resize-pane on
set -g mouse-select-window on

# 문제: macOS에서 pbcopy/pbpaste가 Tmux 내에서 작동하지 않음

# 해결 1: reattach-to-user-namespace 설치 (오래된 macOS)
brew install reattach-to-user-namespace
# .tmux.conf에 추가:
set -g default-command "reattach-to-user-namespace -l $SHELL"

# 해결 2: tmux-yank 플러그인 사용 (추천)
set -g @plugin 'tmux-plugins/tmux-yank'

# 해결 3: Tmux 2.6 이상이면 set-clipboard 활성화
set -g set-clipboard on

# 문제: SSH 재접속 후 tmux ls에 세션이 없음

# 원인 1: Tmux 서버가 종료됨 (시스템 재시작 등)
# 해결: tmux-resurrect와 tmux-continuum 플러그인으로 자동 백업/복원

# 원인 2: 다른 사용자로 SSH 접속
# 확인: Tmux 소켓 위치 확인
ls -la /tmp/tmux-$(id -u)/

# 원인 3: 다른 소켓 경로로 Tmux를 시작한 경우
tmux -L my_socket ls    # 특정 소켓의 세션 확인

# 문제: Tmux 내에서 Tmux를 실행하려 하면 경고가 나타남

# 해결: TMUX 환경변수를 해제하고 실행
unset TMUX && tmux

# 또는 Nested Tmux용 Prefix 설정
# 외부 Tmux: Ctrl-a, 내부 Tmux: Ctrl-b
# 내부 Tmux의 기본 Prefix를 유지하면 자연스럽게 분리된다

# 문제: Tmux 내에서 한글이 깨지거나 잘려서 표시됨

# 해결: UTF-8 설정 확인
# .tmux.conf에 추가 (Tmux 2.2 이전)
set -g utf8 on
setw -g utf8 on

# 터미널의 로케일 설정 확인
locale
# LANG=ko_KR.UTF-8 또는 en_US.UTF-8이어야 한다

# .bashrc 또는 .zshrc에 추가
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

# 현재 버전 확인
tmux -V

# 주요 버전별 기능:
# 2.1: mouse 통합 옵션
# 2.4: copy-mode-vi 테이블
# 2.6: set-clipboard
# 3.0: 정규식 검색, 조건부 바인딩
# 3.2: display-popup
# 3.3: next-prompt / previous-prompt
# 3.4: 커스텀 메뉴

# 최신 버전으로 업그레이드 (Ubuntu)
sudo add-apt-repository ppa:rsurbhi/tmux
sudo apt update && sudo apt install -y tmux

# macOS
brew upgrade tmux

Level 1 (1일차)
├── tmux new / attach / detach / ls / kill-session
├── <prefix> c / n / p (윈도우 생성/전환)
└── <prefix> % / " (페인 분할)

Level 2 (1주차)
├── 페인 이동 (<prefix> 방향키)
├── 페인 줌 (<prefix> z)
├── 복사 모드 (<prefix> [)
└── .tmux.conf 기본 설정

Level 3 (2주차)
├── 커스텀 키바인딩
├── 상태바 커스터마이징
├── 클립보드 연동
└── 마우스 설정

Level 4 (1개월)
├── TPM 플러그인 시스템
├── tmux-resurrect / continuum
├── send-keys 스크립팅
└── tmuxinator / tmuxp 세션 자동화

Level 5 (지속적 개선)
├── display-popup 활용
├── 동기화 모드 (synchronize-panes)
├── Nested Tmux 운영
└── 페어 프로그래밍 세션 공유