tmux config

My tmux setup for remote development with AI coding agents (Claude Code, Codex, etc.).

Features

• Clipboard over SSH — text copy syncs to local clipboard via OSC 52 passthrough
• Image paste bridge — push images from local Mac to remote tmux sessions
• Persistent sessions — auto-save/restore with tmux-resurrect + tmux-continuum
• Catppuccin Mocha theme with top status bar and git branch in pane headers
• Vi mode keybindings in copy-mode
• Mouse support with persistent selection (highlight doesn't vanish on release)
• fzf integration for tmux commands (prefix + Ctrl-f)
• 100K line scrollback history

Plugins

Plugin	Purpose
tpm	Plugin manager
tmux-clipboard-bridge	Clipboard + image paste fix for SSH
tmux-yank	Copy/paste utilities
tmux-resurrect	Save/restore sessions across restarts
tmux-continuum	Auto-save sessions every 5 minutes
catppuccin/tmux	Catppuccin Mocha color scheme
tmux-fzf	fzf-powered tmux commands

Install

# 1. Clone this repo
git clone https://github.com/drewstone/tmux-config.git ~/tmux-config

# 2. Symlink the config
ln -sf ~/tmux-config/tmux.conf ~/.tmux.conf

# 3. Install TPM if you don't have it
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

# 4. Start tmux and install plugins
tmux
# Press prefix + I (capital I) to install all plugins

Key bindings

Copy/paste

Binding	Action
Mouse drag	Select text (highlight persists)
Double-click	Select word
Triple-click	Select line
prefix + [	Enter copy-mode
v (in copy-mode)	Begin selection
y (in copy-mode)	Yank to clipboard
q / Esc	Exit copy-mode

Image clipboard

Binding	Action
prefix + P	Insert latest clipboard image path
prefix + M-p	fzf picker for clipboard images

Pane resizing

Binding	Action
prefix + H/J/K/L	Resize by 10/5
prefix + h/j/k/l	Resize by 2/1

Layouts

Binding	Action
prefix + =	Even horizontal
prefix + -	Even vertical
prefix + \	Main vertical
prefix + _	Main horizontal
prefix + +	Tiled

Other

Binding	Action
prefix + Ctrl-f	fzf tmux commands
prefix + I	Install TPM plugins
prefix + Ctrl-s	Save session
prefix + Ctrl-r	Restore session

Image paste from macOS

See tmux-clipboard-bridge for the tcb local CLI that pushes clipboard images from your Mac to the remote server.

Session persistence

Sessions auto-save every 5 minutes and restore on tmux start. Preserved processes: ssh, node, npm, pnpm, yarn, bun, python3, bash, zsh, fish, claude, codex.