┌─────────────────────────────────────────────────┐
│                  tmux server                     │
│  (백그라운드 프로세스, 모든 세션을 관리)            │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐       │
│  │ Session 0│  │ Session 1│  │ Session 2│       │
│  │ frontend │  │ backend  │  │ devops   │       │
│  └──────────┘  └──────────┘  └──────────┘       │
└─────────────┬──────────┬──────────┬─────────────┘
              │          │          │
       ┌──────┘    ┌─────┘    ┌────┘
       ▼           ▼          ▼
   Client A    Client B   Client C
   (iTerm2)    (Ghostty)  (SSH)

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

# Fedora
sudo dnf install tmux

# 버전 확인
tmux -V

# 새 세션 시작 (이름 자동 부여: 0, 1, 2...)
tmux

# 이름을 지정해서 세션 시작
tmux new-session -s work

# 축약형
tmux new -s work

# ~/.tmux.conf — 최소 필수 설정

# 스크롤백 히스토리 확장 (기본 2,000줄 → 50,000줄)
set -g history-limit 50000

# 마우스 지원 활성화
set -g mouse on

# 윈도우/패인 인덱스를 1부터 시작 (0은 키보드 왼쪽 끝이라 불편)
set -g base-index 1
setw -g pane-base-index 1

# tmux 내부에서 설정 리로드
tmux source-file ~/.tmux.conf

# 또는 prefix + : 로 명령 모드 진입 후
source-file ~/.tmux.conf

# 터미널에서 새 세션 생성
tmux new -s frontend
tmux new -s backend
tmux new -s devops

# 세션 생성 + 첫 윈도우 이름 지정
tmux new -s work -n editor

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

Prefix + : → new -s session-name

# 터미널에서
tmux ls
tmux list-sessions

# tmux 내부에서
Prefix + s    # 세션 목록 (방향키로 선택)
Prefix + w    # 윈도우까지 펼쳐진 전체 목록

# 세션에서 나가기 (세션은 살아있음)
Prefix + d

# 특정 세션에 다시 접속
tmux attach -t frontend
tmux a -t frontend    # 축약형
tmux a               # 마지막 세션에 접속

# 세션이 하나뿐이면
tmux a

# tmux 내부에서 현재 세션 이름 변경
Prefix + $

# 터미널에서 세션 종료
tmux kill-session -t old-session

# 모든 세션 종료
tmux kill-server

# 새 윈도우 생성
Prefix + c

# 윈도우 간 이동
Prefix + n          # 다음 윈도우
Prefix + p          # 이전 윈도우
Prefix + 0          # 0번 윈도우로 직접 이동
Prefix + 1          # 1번 윈도우로 직접 이동
Prefix + l          # 마지막으로 사용한 윈도우로 토글

# 윈도우 이름 변경
Prefix + ,

# 윈도우 찾기 (이름으로 검색)
Prefix + f

# 윈도우를 다른 세션으로 이동
Prefix + : → move-window -t target-session

# 윈도우 순서 변경
Prefix + : → swap-window -t 0

# 수평 분할 (좌우)
Prefix + %

# 수직 분할 (상하)
Prefix + "

# 방향키로 이동
Prefix + ↑↓←→

# 순환 이동
Prefix + o

# 패인 번호로 이동
Prefix + q → 번호 입력

# 방향키로 미세 조절 (prefix + 방향키를 반복)
Prefix + Ctrl+↑     # 위로 1칸 확장
Prefix + Ctrl+↓     # 아래로 1칸 확장
Prefix + Ctrl+←     # 왼쪽으로 1칸 확장
Prefix + Ctrl+→     # 오른쪽으로 1칸 확장

# 마우스로 드래그 (mouse on 설정 시)
# 패인 경계선을 마우스로 잡아 끌기

# 균등 분할 레이아웃 순환
Prefix + Space

# 현재 패인을 윈도우 전체 크기로 확대/축소
Prefix + z

# 패인 위치 교환
Prefix + {       # 이전 패인과 교환
Prefix + }       # 다음 패인과 교환

# 현재 패인을 새 윈도우로 분리
Prefix + !

# 프리셋 레이아웃 순환 (even-horizontal, even-vertical, main-horizontal, main-vertical, tiled)
Prefix + Space

# ~/.tmux.conf — 실전 설정

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

# Prefix 키 변경: Ctrl+b → Ctrl+Space
set -g prefix C-Space
unbind C-b
bind C-Space send-prefix

# 스크롤백 히스토리 (기본 2,000 → 50,000)
set -g history-limit 50000

# 마우스 지원
set -g mouse on

# 윈도우/패인 번호를 1부터
set -g base-index 1
setw -g pane-base-index 1

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

# ESC 지연 제거 (Vim/Neovim 사용자 필수)
set -sg escape-time 0

# 256 색상 지원
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",xterm-256color:Tc"

# ──────────────────────────────────────
# 패인 분할 키 변경 (직관적으로)
# ──────────────────────────────────────

# | 로 수평 분할, - 로 수직 분할
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# 새 윈도우도 현재 경로에서 열기
bind c new-window -c "#{pane_current_path}"

# ──────────────────────────────────────
# Vi 스타일 패인 이동
# ──────────────────────────────────────

bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# Alt + hjkl로 패인 이동 (prefix 없이)
bind -n M-h select-pane -L
bind -n M-j select-pane -D
bind -n M-k select-pane -U
bind -n M-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

# ──────────────────────────────────────
# 복사 모드 (Vi 스타일)
# ──────────────────────────────────────

setw -g mode-keys vi
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"

# ──────────────────────────────────────
# 상태 바 커스터마이징
# ──────────────────────────────────────

set -g status-style "bg=#1e1e2e,fg=#cdd6f4"
set -g status-left "#[fg=#89b4fa,bold] #S "
set -g status-right "#[fg=#a6adc8] %Y-%m-%d %H:%M "
set -g status-left-length 30

# 활성 윈도우 강조
setw -g window-status-current-style "fg=#89b4fa,bold"

# ──────────────────────────────────────
# 설정 리로드 단축키
# ──────────────────────────────────────

bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"

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'
set -g @plugin 'catppuccin/tmux'

# TPM 초기화 (설정 파일 맨 아래에 위치해야 함)
run '~/.tmux/plugins/tpm/tpm'

# tmux-resurrect 설정
set -g @resurrect-capture-pane-contents 'on'
set -g @resurrect-strategy-nvim 'session'

# tmux-continuum 설정
set -g @continuum-restore 'on'        # tmux 시작 시 자동 복원
set -g @continuum-save-interval '15'  # 15분마다 자동 저장

brew install --cask ghostty

# 1. 백그라운드 세션 생성
tmux new-session -d -s agents

# 2. 여러 패인으로 분할
tmux split-window -h -t agents
tmux split-window -v -t agents:0.1

# 3. 각 패인에 명령 전송
tmux send-keys -t agents:0.0 "cd ~/project && claude 'Fix the login bug'" Enter
tmux send-keys -t agents:0.1 "cd ~/project && claude 'Write unit tests'" Enter
tmux send-keys -t agents:0.2 "cd ~/project && npm run dev" Enter

# 4. 특정 패인의 출력 수집
tmux capture-pane -t agents:0.0 -p          # stdout에 출력
tmux capture-pane -t agents:0.0 -p -S -100  # 마지막 100줄
tmux capture-pane -t agents:0.0 -b temp     # 버퍼에 저장

agents:0.0    → "agents" 세션의 0번 윈도우의 0번 패인
agents:0.1    → "agents" 세션의 0번 윈도우의 1번 패인
work:editor.0 → "work" 세션의 "editor" 윈도우의 0번 패인

#!/bin/bash
# ai-workspace.sh — AI 에이전트 병렬 작업 환경 구성

PROJECT_DIR="$1"
SESSION="ai-work"

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

# 메인 세션 생성
tmux new-session -d -s "$SESSION" -c "$PROJECT_DIR" -n "agents"

# 패인 분할: 3개의 에이전트 영역
tmux split-window -h -t "$SESSION:agents" -c "$PROJECT_DIR"
tmux split-window -v -t "$SESSION:agents.1" -c "$PROJECT_DIR"

# 모니터링 윈도우 생성
tmux new-window -t "$SESSION" -n "monitor" -c "$PROJECT_DIR"
tmux split-window -v -t "$SESSION:monitor" -c "$PROJECT_DIR"

# 모니터링 윈도우에 개발 서버 + 로그
tmux send-keys -t "$SESSION:monitor.0" "npm run dev" Enter
tmux send-keys -t "$SESSION:monitor.1" "tail -f logs/app.log" Enter

# agents 윈도우로 돌아가기
tmux select-window -t "$SESSION:agents"

# 접속
tmux attach -t "$SESSION"

#!/bin/bash
# monitor-agents.sh — 모든 패인의 출력을 주기적으로 수집

SESSION="ai-work"
OUTPUT_DIR="/tmp/agent-outputs"
mkdir -p "$OUTPUT_DIR"

while true; do
    # 모든 패인의 최근 출력 수집
    for pane in $(tmux list-panes -t "$SESSION" -F '#{pane_id}'); do
        tmux capture-pane -t "$pane" -p -S -50 > "$OUTPUT_DIR/${pane}.txt"
    done

    # 특정 키워드 감지 (에러, 완료 등)
    if grep -q "Error\|FAIL\|Complete\|Done" "$OUTPUT_DIR"/*.txt 2>/dev/null; then
        echo "[$(date)] Agent activity detected"
    fi

    sleep 10
done

# Copy Mode 진입
Prefix + [

# Copy Mode에서의 이동 (vi 모드 설정 시)
h/j/k/l        # 방향 이동
Ctrl+u/d        # 페이지 업/다운
g/G             # 처음/끝으로 이동
/search-term    # 텍스트 검색
n/N             # 다음/이전 검색 결과

# 텍스트 선택 및 복사 (vi 모드)
Space           # 선택 시작
Enter           # 선택한 텍스트 복사 + Copy Mode 종료
q               # Copy Mode 종료 (복사 없이)

# 복사한 텍스트 붙여넣기
Prefix + ]

# 동기화 활성화: 현재 윈도우의 모든 패인에 동일한 입력 전송
Prefix + : → setw synchronize-panes on

# 동기화 비활성화
Prefix + : → setw synchronize-panes off

# .tmux.conf에 토글 단축키 추가
bind S setw synchronize-panes \; display-message "Sync #{?synchronize-panes,ON,OFF}"

# 레이아웃 순환
Prefix + Space

# 특정 레이아웃 직접 지정
Prefix + : → select-layout even-horizontal    # 수평 균등 분할
Prefix + : → select-layout even-vertical      # 수직 균등 분할
Prefix + : → select-layout main-horizontal    # 상단 메인 + 하단 분할
Prefix + : → select-layout main-vertical      # 좌측 메인 + 우측 분할
Prefix + : → select-layout tiled              # 타일 형태

# 자주 쓰는 명령 모드 명령
new -s session-name           # 새 세션
move-window -t other-session  # 윈도우를 다른 세션으로 이동
swap-pane -U                  # 패인 위치 위로 이동
swap-pane -D                  # 패인 위치 아래로 이동
resize-pane -D 10             # 아래로 10칸 확장
resize-pane -R 20             # 오른쪽으로 20칸 확장

H = ← (왼쪽)
J = ↓ (아래)
K = ↑ (위)
L = → (오른쪽)