session-tools/tmux.conf

# Reduce escape sequence latency — default 500ms makes scroll feel completely broken
# in TUI apps (Claude Code, vim, etc.) because each wheel event uses escape sequences.
set -s escape-time 10

# Pass focus events through to applications (Claude Code uses these)
set -g focus-events on

# True color passthrough
set -ga terminal-overrides ",*256col*:Tc"

# Larger scrollback for when you need tmux copy mode
set -g history-limit 50000

# Mouse wheel scrolls tmux scrollback (auto-enters copy mode) instead of being
# passed as arrow keys to the inner app (which would scroll Claude history etc.)
# Hold Option on macOS to bypass tmux and use native terminal selection.
set -g mouse on

# Resize panes to the active client's size, not the smallest attached. Matters
# when reattaching the same durable session from different terminals (phone,
# laptop, IDE pane) — otherwise the layout collapses to the smallest viewer.
setw -g aggressive-resize on

# Forward copy-mode selections to the OS clipboard via OSC 52, so mouse-drag
# or `y` in copy mode actually lands in the local terminal's clipboard even
# across ssh + tmux.
set -g set-clipboard on

# Keep window indexes contiguous when one closes; quiet the activity flag spam.
set -g renumber-windows on
setw -g monitor-activity off