| name | managing-tmux |
| description | Configure tmux: plugins (resurrect, thumbs, yank), Pane Notepad.
Trigger: 'tmux 설정', 'tmux 플러그인', 'pane notepad', 'tmux-resurrect', 'tmux 단축키', 'tmux 세션 복원'.
NOT for SSH (use managing-ssh). NOT for Atuin (use syncing-atuin).
|
tmux 설정
터미널 멀티플렉서 tmux 설정 및 단축키 가이드입니다.
목적과 범위
tmux 기본 동작, 플러그인, Pane Notepad를 다룬다.
빠른 참조
주요 설정 파일
| 파일 | 용도 |
|---|
modules/shared/programs/tmux/default.nix | Home Manager tmux 모듈 (플러그인 포함) |
modules/shared/programs/tmux/files/tmux.conf | tmux 설정 파일 |
modules/shared/programs/tmux/files/scripts/ | Pane Notepad + 보조 스크립트 |
주요 스크립트
| 스크립트 | 용도 |
|---|
find-unused-prefixes.sh | tmux prefix 키 중 미사용 조합 탐지 |
pane-note.sh | 노트 생성/편집 |
pane-link.sh | 노트 검색/연결 |
pane-tag.sh | 노트 태그 수정 |
핵심 절차
modules/shared/programs/tmux/files/tmux.conf에서 키맵과 기본 동작을 조정한다.modules/shared/programs/tmux/default.nix에서 plugin 목록과 Home Manager 옵션을 맞춘다.- Pane Notepad는
pane-note.sh와 pane-link.sh로 생성/연결을 수행한다.
- 세션 저장/복원은 tmux-resurrect/tmux-continuum 상태를 확인한다.
주요 Nix 옵션 (programs.tmux)
default.nix에서 Home Manager 내장 옵션을 활용하여 기본 설정을 선언적으로 관리합니다:
| 옵션 | 값 | 설명 |
|---|
terminal | "tmux-256color" | 기본 터미널 타입 |
mouse | true | 마우스 지원 |
historyLimit | 50000 | 스크롤백 히스토리 |
escapeTime | 10 | Escape 키 지연 (ms) |
baseIndex | 1 | 창 번호 시작 |
keyMode | "vi" | copy-mode에서 vi 키바인딩 |
focusEvents | true | Neovim autoread 지원 |
플러그인
| 플러그인 | 용도 |
|---|
| tmux-resurrect | 세션 저장/복원 (pane 변수 포함) |
| tmux-continuum | 15분 간격 자동 저장 + 서버 시작 시 자동 복원 |
| tmux-yank | 시스템 클립보드 연동 (copy-mode) |
| tmux-thumbs | 화면에서 URL/경로/해시 등을 힌트로 선택하여 tmux buffer에 복사 |
Pane Notepad
폴더 구조
~/.tmux/pane-notes/
├── {repo}/ # Git 저장소 이름 (예: nixos-config)
│ └── {title}.md # 노트 파일
├── _archive/ # 아카이브된 노트
└── _trash/ # 삭제된 노트
YAML Frontmatter
각 노트 파일은 YAML frontmatter로 메타데이터를 관리합니다:
---
title: 노트 제목
tags: [버그, 기능]
created: 2026-01-25
repo: nixos-config
---
스크립트 목록, 태그 시스템, 링크 파일, 디버그 상세는 references/pane-notepad.md 참조.
트러블슈팅
prefix 충돌, plugin 로드 실패, Pane Notepad 오류는 references/troubleshooting.md를 우선 확인한다.
참조
