tmux-sensible은 tmux 사용자라면 거의 필수적으로 설치하는 최우선 플러그인입니다. 리눅스 커뮤니티의 거장인 Tim Pope가 개발한 것으로, “tmux의 기본 설정(Default)이 너무 보수적이고 불편하니, 누구나 동의할 만한 상식적인(Sensible) 옵션들로 기본값을 바꾸자”라는 목적으로 만들어졌습니다.
WSL(Ubuntu 24.04)과 원격 서버(Ubuntu 26.04)를 오가며 Windows Terminal로 작업하시는 사용자님의 환경에서, 이 플러그인이 왜 중요한지 핵심 역할과 미사용 시 불편한 점을 정리해 드립니다.
1. tmux-sensible이 자동으로 잡아주는 핵심 역할
이 플러그인을 설치하면 ~/.tmux.conf에 복잡한 코드를 일일이 적지 않아도 다음과 같은 강력한 기본 설정들이 적용됩니다.
키 입력 지연 시간 제거 (escape-time 0): Vim/Neovim을 쓸 때 Esc 키를 누르면 즉시 모드가 바뀌도록 지연 시간을 없애줍니다.
히스토리 버퍼 대폭 확장 (history-limit 50000): 터미널 로그를 위로 스크롤해서 볼 수 있는 줄 수를 기본 2,000줄에서 50,000줄로 대폭 늘려줍니다.
256화면 색상 및 True Color 활성화: 윈도우 터미널 환경에서 현대적인 화려한 테마(NeoVim 내부 테마, 로고 등)가 깨지지 않고 정확한 색상으로 출력되도록 환경 변수를 잡아줍니다.
단축키 반복 시간 최적화 (repeat-time 600): 윈도우나 팬 크기를 조절할 때 단축키를 너무 연속으로 누르지 않아도 부드럽게 작동하도록 조절합니다.
2. 이 플러그인을 쓰지 않을 때 발생하는 치명적인 불편함
만약 tmux-sensible 없이 순정 상태의 tmux를 사용하면 다음과 같은 짜증 나는 상황들을 겪게 됩니다.
① Vim 사용 시 Esc 키 지연 현상 (가장 고통스러움)
순정 tmux는 Esc 키가 입력된 후 0.5초(500ms) 동안 다음 키가 들어오는지 기다립니다. 이 때문에 Vim에서 수정 모드를 빠져나오려고 Esc를 누른 뒤 바로 방향키를 누르면, 모드가 풀리는 게 아니라 엉뚱한 명령 시퀀스로 인식되어 코드가 뒤죽박죽 꼬여버립니다.
② 윈도우 터미널에서 빔(Vim) 테마 색상 깨짐
최신 윈도우 터미널은 수백만 가지 색상(True Color)을 표현할 수 있습니다. 하지만 순정 tmux는 구시대적인 8색/16색 모드로 시작하는 경우가 많아, 고급스러운 개발자용 빔 테마를 켜도 색상이 칙칙하게 뭉개지거나 아예 가독성이 떨어지는 색으로 변해버립니다.
③ 조금만 빌드 로그가 길어져도 위쪽 내용이 잘림
앞서 LLM 관련 컴파일(llama.cpp 빌드 등)이나 대용량 로그를 출력할 때, 순정 tmux는 기본 버퍼가 2,000줄밖에 되지 않습니다. 컴파일 도중 에러가 나서 위로 스크롤(Ctrl + B 후 [)을 해보면, 에러의 시작점이 이미 잘려 나가서 정작 중요한 에러 원인을 파악하지 못하는 상황이 발생합니다.
④ Ctrl + B 단축키 연속 입력의 피로감
순정 상태에서는 윈도우를 넘나들거나 팬을 다룰 때, 리눅스가 단축키 대기 시간을 너무 타이트하게 잡거나 반대로 너무 길게 잡아서 명령이 씹히는 느낌을 자주 받게 됩니다.
💡 요약 및 추천
tmux-sensible은 특이하고 기상천외한 기능을 추가해 주는 플러그인이 아닙니다. 단지 “당연히 이래야지” 싶은 현대적인 개발 환경 표준을 명령어 한 줄로 세팅해 주는 패키지입니다.
side-bar
현재 경로의 디렉터리 트리 표시에 가장 널리 사용되는 tmux-sidebar 플러그인
.tmux.conf 에 등록하고 설치하면 된다.
1
set -g @plugin 'tmux-plugins/tmux-sidebar
기본 단축키는 다음과 같습니다
C + Tab : 디렉터리 트리 사이드바를 열거나 닫습니다(토글). 커서는 원래 패널에 유지됩니다.
# List of plugins set -g @plugin 'tmux-plugins/tpm' set -g @plugin 'tmux-plugins/tmux-sensible' # other plugins ... # Initialize TMUX plugin manager # (keep this line at the very bottom of tmux.conf) run '~/.tmux/plugins/tpm/tpm'
이제부터 15분 마다 자동 저장하고 서버를 재시작한 후에 tmux를 다시 시작하면 저장한 환경을 자동으로 복구해 준다.
키 바인딩
세션 수동 저장: Ctrl + b 누른 후 Ctrl + s (Resurrect 기능)
세션 수동 복원: Ctrl + b 누른 후 Ctrl + r (Resurrect 기능)
tmux 세션을 모두 나와서 tmux 서버를 모두 kill-session 같은 명령으로 종료시킨후 tmux를 다시 시작하면 .tmux/resurrect 에 저장된 마지막 세션이 복구되는 것을 확인할 수 있다.
tmux 무한 exited 문제
tmux-resurrect와 continuum은 가끔 문제를 일으킨다.
재시작 등의 이유로 이전 저장한 세션을 탑재중 무한 exited 로 종료되는 상황이 그것이다.
예를 들어 tmux2k 설정중 시스템 locale 을 다시 설정하게 된 후 tmux 가 exited 되는 문제가 발생했다.
세션을 모두 빠져나간다
1
$ tmux kill-server # 다른 터미널에서 실행
방법1:
.tmux.conf 에서 set -g @continuum-restore ‘on’을 #으로 주석 처리
tmux 실행 후 정상 작동 확인후 안되면 방법2로 모든 세션을 초기화 한다.
방법2. continuum 세션 삭제
continuum 의 세션은 백업 파일이 꼬여서 그런것 같다.
tmux-resurrect와 continuum은 세션 정보를 특정 디렉토리에 텍스트 파일로 저장하고 있다.
기본 저장 위치는 아래와 같다.
1 2 3 4 5
$ ls -l .local/share/tmux/resurrect/ total 4 lrwxrwxrwx 1 user user 34 5월 29 21:47 last -> tmux_resurrect_20260529T214713.txt -rw-r--r-- 1 user user 239 5월 29 21:36 tmux_resurrect_20260529T213616.txt -rw-rw-r-- 1 user user 0 5월 29 21:47 tmux_resurrect_20260529T214713.txt
tmux 세션을 만들고, 세션에서 window를 구성하고, window 안에 pane에 대해서 요약
새로운 세션 시작하기
1 2
$ tmux #새로운 새션 $ tmux new -s session_name #session_name으로 새로운 세션
세션을 dettach하면 세션은 저장된다. 사용하지 않으면 kill로 종료한다.
세션 이용하기
1 2 3
$ tmux ls $ tmux list-session $ tmux list-windows # Window 목록
열린 세션에 붙기.
세션 번호중 낮은 번호에 우선해서 접속한다.
1 2 3
$ tmux attach $ tmux at $ tmux a
특정 세션에 접속하기
세션 번호 혹은 이름으로 접속한다.
1
$ tmux a -t session_name
세션 마감하기
1
$ tmux kill-session session_name
Tmux pane
Tmux로 접속한 session은 처음 한개의 Window를 갖는다. window 안에서 session, window, pane을 관리한다. 각 윈도우는 한 개 이상의 Pane 구획으로 나누어 사용할 수 있다.
Tmux window를 여러 분할면 pane으로 나눠 사용한다.
1 2 3 4 5 6 7 8 9 10 11
C-% # 수직으로 나누기 C-" # 수평으로 나누기 C-z # 현재 pane 확대 및 돌아오기 C-{ # 현재 pane을 이전 pane 위치로 이동 C-} # 현재 pane을 다음 pane 위치로 이동 C-Arrow # 앞,뒤 pane을 방향키로 이동 C-M+Arrow # pane 크기를 방향키에 따라 변경 C-spacebar # pane 방향 전환 (수직<->수평) C-! # 현재 pane을 새 window로 분리 C-x # 현재 pane을 종료 C-[ # pane에서 스크롤 기능을 활성화
Tmux copy & paste
tmux 는 자체 버퍼에 터미널에서 선택한 영역의 텍스트를 복사해서 사용할 수 있다.
1 2 3 4
C-[ # copy mode Ctrl+space # 복사할 영역을 선택한다. 터미널에 영역이 선택되어 보인다. Ctrl+w # 선택한 영역을 복사한다. C-] # 붙여 넣는다.
Tmux Window
현재 세션 이용
1 2
C-s #Session 목록 C-$ #Session 이름 변경
세션에서 여러 윈도우를 추가 해서 사용할 수 있다.
1
C-c #새로운 윈도우 생성
여러 윈도우는 윈도우 순서에 따라 현재 윈도우 화면을 교환 할 수 있다.
1 2 3 4 5 6 7
C-w #윈도우 목록 C-1 ... #지정 윈도우 번호로 전환: 0,1,... C-p #이전 윈도우로 이동 C-n #다음 윈도우로 이동 C-l #가장 마지막 윈도우로 이동 C-, #현재 윈도우 이름 변경 C-& #현재 윈도우 제거
현재 세션에서 나온다. 세션은 백그라운드에서 실행된다.
1 2
C-d #현재 세션을 빠져 나온다 (detach) C-D #빠져나올 세션을 선택할 수 있다.
detach 는 외부 터미널에서 tmux detach 를 실행하면 현재 tmux 세션이 분리된다.
Session transition
Tmux window 상태에서 여러 세션 사이의 전환 단축키;
1 2 3 4 5
C-$ # 현재 세션 이름 바꾸기 C-( # 이전 세션으로 전환 C-) # 다음 세션으로 전환 C-L # 사용한 세션중 마지막 세션으로 전환 C-s # 사용 가능한 세션 목록
단, 시스템 버퍼는 별도의 플러그인을 사용한다.
재미있는 설정
마우스 모드 활성화
설정에 mouse mode 활성화를 .tmux.conf 설정으로 지정.
1
set -g mouse on
설정을 탑재하면 1. 마우스 드래그로 선택한 버퍼 복사 2. Shift 마우스 드래그로 일반 Copy 수행.
버퍼 크기
1 2
# scrollback buffer size increase set -g history-limit 100000
Pane 이동
M 와 방향키로 바인딩해서 prefix 없이 사용.
1 2 3 4 5
# Use Alt-arrow keys without prefix key to switch panes 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
상태바 컬러
1 2 3
# bar color set -g status-bg black set -g status-fg white
$ tmux # 세션을 시작하고 참가한다. $ tmux new -s foo # 세션 foo를 시작하고 참가한다
세션에 참가하면 하나 혹은 그 이상의 윈도우에서 Pane을 배치해 사용할 수 있다.
[그림. Tmux window layout]
Control와 Meta key
Tmux 세션 참가후 Window에서는 Prefix key로 Session, Window, Pane 관련 명령을 키로 조합해 사용한다. 기본 Prefix key는 Control+b key고 옵션으로 사용하는 Meta key는 Alt 키 이다.
여기서 Prefix key는 C와 조합으로 표기하고, Meta key인 Alt는 M으로 표기한다.
윈도우 명령 control, meta 키 조합과 병행해 윈도우에서 명령모드를 사용할 수 있다. 명령모드는 C-: 키로 시작하고, 명령모드에서 명령 자동 완성을 지원한다.
[그림. Window command mode]
Pane 다루기
윈도우는 수직/수평으로 구획을 나눌수 있다. C-“ 키로 현재 Pane 아래에 수평으로 새 Pane을 나눈다. 그리고 **C-%**키로 수직으로 새 Pane을 나눌 수 있다.
[그림. Tmux Window Pane]
C-q : pane 번호를 표시하고 번호를 눌러서 이동
C-o : pane을 순서대로 이동
C-방향키 : 해당 방향으로 이동
C-M-방향키 : 해당 방향으로 크기 조절
C-M-1~5 : 몇 가지 미리 설정된 레이아웃을 고를 수 있고, prefix space로 이 레이아웃을 순서대로 - 돌아가며 선택 가능
C-z : 특정화면만 확대하기 다시 예전 Panes상태로 돌아오기
Pane을 지우려면 터미널 exit 명령 혹은 C-x 키로 빠져 나올 수 있다.
Window 다루기
윈도우는 명령모드에서 new-window 혹은 C-c 키로 새 윈도우를 추가할 수 있다.
[그림. new Window ]
윈도우 사이의 이동은 윈도우 번호에 따라 단축키 C-0,1,2…9를 사용하거나 C-w로 윈도우 목록에서 선택해 이동할 수 있다.
C-n, C-p : 다음 윈도우, 이전 윈도우로 이동
C-l : 직전 사용하던 윈도우로 이동
C-w : 윈도우 리스트를 띄우고 선택
C-, : 윈도우 이름 바꾸기
세션 사용중에 세션을 빠져 나오려면 C-d 로 detach 하거나, 명령모드 C-:에서 detach 명령을 준다.
복사와 스크롤
Tmux 화면 버퍼는 한 화면분 밖에 안되서, 이전 화면 내용을 보려면 스크롤 기능을 켜야 한다. C+[ 키는 스크롤 키고, 우측상단에 페이지 표시가 나타난다. 키보드 방향키나 Page Up/Down키로 스크롤이 가능하다.
세션 연결
세션은 하나 혹은 그 이상 만들고 attach 명령으로 세션에 참가할 수 있다.
1 2 3 4
$ tmux new -s foo -d # 세션 foo를 시작하고 빠져나온다. $ tmux ls # 세션 목록을 출력한다. 0: 1 windows (created Fri May 12 10:26:00 2017) [80x24] (attached) foo: 1 windows (created Fri May 12 10:34:18 2017) [80x24]
터미널에서 세션에 참가하려면 attach 명령과 대상 세션을 지정해 준다. 대상 세션은 tmux ls 명령에 표시되는 세션번호 혹은 세션이름을 지정한다.
set -g @plugin 'tmux-plugins/tmux-resurrect' set -g @plugin 'tmux-plugins/tmux-continuum'
tmux 에서 플러그인 설치를 위해서 C-I (대문자) 를 실행
그리고 .tmux.conf 파일에 continuum-restore 을 on으로 해준다.
1
set -g @continuum-restore 'on'
tmux 세션을 모두 나와서 tmux 서버를 모두 kill-session 같은 명령으로 종료시킨후 tmux를 다시 시작하면 .tmux/resurrect 에 저장된 마지막 세션이 복구되는 것을 확인할 수 있다.
이제부터 15분 마다 자동 저장하고 서버를 재시작한 후에 tmux를 다시 시작하면 저장한 환경을 자동으로 복구해 준다.
tmux status 표시
tmux-continuum 의 상태를 tmux status line에 표시할 수 있다.
1
set -g status-right 'Continuum status: #{continuum_status}'
Linux에서 tmux 자동 시작
tmux-continuum 은 Linux systemd, macOS 에서 자동 시작을 지원한다.
Linux는 .tmux.conf 파일에 다음 부트 옵션을 추가한다.
1
set -g @continuum-boot 'on'
그리고 현재 실행중인 세션에 변경한 설정을 적용하려면
1
$ tmux source-file ~/.tmux.conf
macOS에서 tmux 자동 시작
.tmux.conf 파일에 다음 부트 옵션을 추가한다.
1
set -g @continuum-boot 'on'
그리고 현재 실행중인 세션에 변경한 설정을 적용한다.
1
$ tmux source-file ~/.tmux.conf
맥이 재시작 하면 자동으로 Terminal.app 이 실행된다. 터미널 크기는 다음 옵션으로 지정한다:
1 2 3 4
set -g @continuum-boot-options 'fullscreen'# terminal window will go fullscreen set -g @continuum-boot-options 'iterm'# start iTerm instead of Terminal.app set -g @continuum-boot-options 'iterm,fullscreen'# start iTerm in fullscreen
다중 tmux 서버는 지원하지 않는다.
tmux 로 서버를 하나 시작하고, tmux -S /tmp/foo 같이 다른 소켓을 사용했다고 자동 저장/복구가 별도로 진행되지 않는다. [^10]
