Agent skill
managing-tmux
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).
Stars
1
Forks
0
Install this agent skill to your Project
npx add-skill https://github.com/greenheadHQ/nixos-config/tree/main/.claude/skills/managing-tmux
SKILL.md
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로 메타데이터를 관리합니다:
yaml
---
title: 노트 제목
tags: [버그, 기능]
created: 2026-01-25
repo: nixos-config
---
스크립트 목록, 태그 시스템, 링크 파일, 디버그 상세는 references/pane-notepad.md 참조.
트러블슈팅
prefix 충돌, plugin 로드 실패, Pane Notepad 오류는 references/troubleshooting.md를 우선 확인한다.
참조
- Pane Notepad 상세: references/pane-notepad.md
- 단축키 가이드: references/shortcuts.md
- 트러블슈팅: references/troubleshooting.md
Didn't find tool you were looking for?