Tmux configuration — keybindings, status bar, plugins

Find a file

Lucas Draney 35ed3cda3f Add plugins and config docs, rewrite README as TOC (#8 )		2026-06-12 04:45:43 +00:00
docs	Add plugins and config docs, rewrite README as TOC (#8 )	2026-06-12 04:45:43 +00:00
.tmux-battery.conf	Initial commit of minimal tmux configuration	2025-09-09 00:08:29 -06:00
.tmux.conf	Fix window move to insert instead of swap (#2 )	2026-03-26 04:17:27 +00:00
README.md	Add plugins and config docs, rewrite README as TOC (#8 )	2026-06-12 04:45:43 +00:00

README.md

tmux-custom

Personal tmux configuration. Symlinked to ~/.tmux.conf -- edit here, reload there.

Setup

# Symlink config
ln -s ~/tmux-custom/.tmux.conf ~/.tmux.conf

# Install TPM (plugin manager)
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# Reload and install plugins
tmux source ~/.tmux.conf    # then prefix + I inside tmux

Docs

Session Management -- navigating, creating, switching, and persisting sessions
Plugins -- what each plugin does, keybindings, and config overrides
Config Reference -- annotated walk-through of .tmux.conf

Features

Mouse support with drag-to-reorder windows
Clickable session name in status bar
Vi mode copy with OS-aware clipboard (macOS/X11/WSL2)
Session persistence across reboots (resurrect + continuum)
Catppuccin theme with prefix highlight
Cross-platform detection (no manual config per machine)
New panes/windows inherit current working directory
Auto-rebalance panes on split/close