tmux.conf

# Claude Code optimized tmux config
# Copy to ~/.tmux.conf
#
# Key feature: mouse scroll works naturally — wheel up enters copy mode
# automatically. Your viewport is completely decoupled from Claude Code's
# cursor repositioning. No more scroll jumping.

# --- Core scroll fix ---
# Mouse scroll works naturally — wheel up enters copy mode automatically
set -g mouse on

# 100K line scrollback (default 2000 is way too small for Claude sessions)
set -g history-limit 100000

# --- Performance ---
# Don't wait for escape sequences (instant response to keybinds)
set -sg escape-time 0

# Faster key repeat
set -g repeat-time 200

# --- Display ---
# True color support
set -g default-terminal "screen-256color"
set -sa terminal-features ",xterm-256color:RGB"

# Status bar — minimal, shows pane count and time
set -g status-style bg=colour235,fg=colour248
set -g status-left "#[fg=colour39][tmux] "
set -g status-right "#[fg=colour243]panes:#{window_panes} | %H:%M"
set -g status-left-length 20

# Active pane border highlight (for split panes)
set -g pane-active-border-style fg=colour39
set -g pane-border-style fg=colour238

# --- Quality of life ---
# Ctrl+B then | for vertical split, - for horizontal (more intuitive)
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"

# New windows/panes start in current directory
bind c new-window -c "#{pane_current_path}"

# Ctrl+B then r to reload config
bind r source-file ~/.tmux.conf \; display-message "Config reloaded"

# Vi-style copy mode (more natural scrolling with j/k)
setw -g mode-keys vi