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).
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로 메타데이터를 관리합니다:
---
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
greenheadHQ/nixos-config
managing-mise
Manage mise runtime: Node.js, pnpm, shims. Trigger: 'mise 설정', 'pnpm not found', '.nvmrc', 'mise shims', 'mise activate', '런타임 버전 불일치'.
greenheadHQ/nixos-config
configuring-git
Configure Git via Home Manager: delta, lazygit, rerere. Trigger: 'git 설정 충돌', 'delta 설정', 'lazygit', 'rerere', 'git-cleanup', 'git 브랜치 정리'.
greenheadHQ/nixos-config
configuring-neovim
Configure Neovim (LazyVim) via Nix: plugins, LSP, formatters, linters, themes, treesitter, im-select. Default editor skill — generic '에디터', '편집기', '코드 편집기' queries route here unless the request is explicitly about Zed or another editor-specific path. Trigger: 'neovim', 'LSP', 'lazy.nvim', 'treesitter', '한영 전환', 'im-select', '에디터', '코드 편집기', '편집기 설정', 'colorscheme', 'catppuccin', 'formatter', 'linter', 'extraPackages', '자동완성', 'syntax highlighting', 'language server', '코드 편집'. NOT for Zed/확장 (→ modules/darwin/programs/zed/). NOT for VSCode (제거됨, #329).
greenheadHQ/nixos-config
managing-secrets
Manage encrypted secrets with agenix: .age files, re-encryption, decryption failures. Trigger: '시크릿', '암호화', '복호화', 'agenix', 'secrets.nix', 'age key', '.age', '토큰 추가', 're-encrypt', '/run/agenix'. NOT for Vaultwarden 비밀번호 관리자 (use hosting-vaultwarden).
greenheadHQ/nixos-config
managing-ssh
Configure SSH, Tailscale VPN, mosh, sudo auth. Trigger: 'SSH 인증 실패', 'Tailscale', 'ssh-agent 문제', 'MagicDNS', 'mosh', 'authorized_keys 설정'. NOT for tmux (use managing-tmux). NOT for Atuin (use syncing-atuin).
greenheadHQ/nixos-config
managing-macos
Configure macOS/nix-darwin: Dock, Finder, Homebrew Cask, Folder Actions. Trigger: 'darwin-rebuild', 'shottr 설정', 'Folder Actions', 'compress-video', 'upload-immich'.
Didn't find tool you were looking for?