tmux-config

A batteries-included tmux configuration with vi keybindings, right-click context menus, and macOS light/dark theme auto-detection.

Install

git clone https://github.com/cross-entropy-ai/tmux-config.git ~/.config/tmux

Have an agent install it for you

Paste this prompt to Claude Code (or any coding agent):

Please install the tmux config from https://github.com/cross-entropy-ai/tmux-config by cloning it to ~/.config/tmux. If ~/.config/tmux or ~/.tmux.conf already exists, back it up first. After installing, tell me how to reload my current tmux session.

Reload

Inside a running tmux session, apply the new config without restarting:

• From any shell:

  tmux source ~/.config/tmux/tmux.conf

If you're not already in a tmux session, just run tmux — the config loads automatically on start.

Features

• Prefix: Ctrl+a
• Vi-style navigation and copy mode
• Mouse support (scroll, select, resize)
• Right-click context menus for panes, windows, and sessions
• Auto light/dark theme (Tokyo Night, detects macOS appearance)
• Extended keys support (Shift+Enter in Claude Code, etc.)

Requirements

• tmux 3.2+
• macOS (for auto light/dark detection; defaults to light on other platforms)