| name | tmux |
| description | Tmux terminal multiplexer - Catppuccin theme, TPM plugins, custom scripts, session/worktree management, and key bindings |
| metadata | {"tags":"tmux, terminal, multiplexer, catppuccin, tpm, plugins, session-management"} |
When to use
Use this skill for:
- Tmux configuration, key bindings, and plugin management
- Session, window, pane operations (create, navigate, resize, kill)
- Tmux-resurrect/continuum save/restore workflow
- Custom scripts (worktree-select, window-select-hint, opencode integration)
- Catppuccin theme and status bar customization
How to use
This skill is organized into reference files by topic:
Read only the reference file relevant to your current task.
Quick Reference
Configuration Files
| File | Purpose |
|---|
~/.config/tmux/tmux.conf | Main config (symlinked by yadm) |
~/.config/tmux/tmux.conf##os.Darwin | macOS-specific overrides |
~/.config/tmux/tmux.conf##os.Linux | Linux-specific overrides |
~/.config/tmux/scripts/*.sh | Custom scripts |
Prefix: Ctrl-Space — see references/keybindings.md for the full table.
Common Operations
tmux source-file ~/.config/tmux/tmux.conf
prefix + -
prefix + \
Alt--
Alt-\
tmux new-session -s name
tmux switch-client -t name
tmux kill-session -t name
tmux new-window -c "#{pane_current_path}"
tmux rename-window -t <id> "new-name"
tmux kill-window -t <id>
prefix + C-s
prefix + C-r
prefix + p
prefix + P
prefix + _
prefix + C-p
prefix + e
Best Practices
- Save often — continuum auto-saves every 15 min; manual
prefix + C-s before risky ops
- OS-specific configs — yadm symlinks the correct
tmux.conf##os.<OS> per machine
- TPM after clone — run
prefix + I on new machine to install plugins
- Worktree workflow — use
Alt-w or prefix + w for worktree-select.sh to jump between git worktrees
- Prefix conflict —
prefix + C-Space sends literal Ctrl-Space to the pane