Files

1.9 KiB

tmux

Terminal multiplexer configuration managed via chezmoi.

Configuration

~/.tmux.conf - sourced from chezmoi at ~/.local/share/chezmoi/dot_tmux.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