sync

tmux.md

@@ -0,0 +1,70 @@
+# tmux
+
+Terminal multiplexer configuration managed via [[chezmoi]].
+
+## Configuration
+
+`~/.tmux.conf` - sourced from chezmoi at `~/.local/share/chezmoi/dot_tmux.conf`
+
+```conf
+# TPM - Tmux Plugin Manager
+set -g @plugin 'tmux-plugins/tpm'
+set -g @plugin 'tmux-plugins/tmux-sensible'
+
+# Session persistence
+set -g @plugin 'tmux-plugins/tmux-resurrect'
+set -g @plugin 'tmux-plugins/tmux-continuum'
+
+# Resurrect options
+set -g @resurrect-capture-pane-contents 'on'
+
+# Continuum options
+set -g @continuum-restore 'on'
+set -g @continuum-save-interval '15'
+
+# Initialize TPM (must be at the bottom)
+run '~/.tmux/plugins/tpm/tpm'
+
+# Base settings
+set-option -g mouse
+set-window-option -g window-size latest
+set-window-option -g aggressive-resize on
+```
+
+## Plugins
+
+### TPM (Tmux Plugin Manager)
+Plugin manager for tmux. Install new plugins by adding them to `.tmux.conf` then pressing `prefix + I`.
+
+### tmux-sensible
+Basic settings that most tmux users want. Included by default.
+
+### tmux-resurrect
+Saves and restores tmux environment after restart.
+
+- `prefix + Ctrl-s` - Save current environment
+- `prefix + Ctrl-r` - Restore last save
+
+Saves: sessions, windows, panes, layouts, working directories, running programs
+
+### tmux-continuum
+Automatic saving and restoring. Requires tmux-resurrect.
+
+- Auto-saves every 15 minutes (configurable via `@continuum-save-interval`)
+- Auto-restores on tmux start when `@continuum-restore 'on'`
+
+Saves stored in `~/.tmux/resurrect/` (~5KB per save)
+
+## Base Settings
+
+| Setting | Description |
+|---------|-------------|
+| `mouse` | Enable mouse support (click, scroll, resize) |
+| `window-size latest` | Use newest window size when creating new windows |
+| `aggressive-resize` | Aggressively resize windows to fit smallest client |
+
+## Installation
+
+After updating `.tmux.conf`:
+1. Reload config: `tmux source-file ~/.tmux.conf`
+2. Install plugins: press `prefix + I` inside tmux