# 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