tmux

# tmux Terminal Multiplexer Skill

This skill provides guidance for working with tmux, a terminal multiplexer that enables multiple terminal sessions, windows, and panes within a single terminal window.

## When to Use This Skill

Use this skill when:
- Creating or managing tmux sessions, windows, or panes
- Configuring tmux keybindings or settings in `~/.tmux.conf`
- Building workflows that leverage tmux for multi-file review or parallel tasks
- Troubleshooting tmux configuration issues
- Setting up custom tmux-based tools or functions

## User's tmux Configuration

The user has a custom tmux configuration at `~/.tmux.conf` with ergonomic keybindings optimized for file review workflows.

### Custom Keybindings

**Easy Window Navigation:**
- `Option+]` or `Ctrl+Shift+]` - Next window
- `Option+[` or `Ctrl+Shift+[` - Previous window
- `Option+{` - Move current window left
- `Option+}` - Move current window right

**Direct Window Jumping:**
- `Option+0` through `Option+9` - Jump directly to window 0-9

**Pane Switching:**
- `Option+Left/Right/Up/Down` - Navigate between panes

**Synchronization:**
- `Ctrl-b e` - Toggle pane synchronization (send commands to all panes)

**Standard tmux Keys (still available):**
- `Ctrl-b n` - Next window
- `Ctrl-b p` - Previous window
- `Ctrl-b w` - List all windows (visual selector)
- `Ctrl-b d` - Detach from session
- `Ctrl-b c` - Create new window
- `Ctrl-b ,` - Rename current window
- `Ctrl-b &` - Kill current window
- `Ctrl-b x` - Kill current pane
- `Ctrl-b "` - Split pane horizontally
- `Ctrl-b %` - Split pane vertically

### Configuration Features

The user's `~/.tmux.conf` includes:

```bash
# Mouse support enabled for scrolling and pane selection
set -g mouse on

# Pane border status showing index and running command
set -g pane-border-status top
set -g pane-border-format " #{pane_index} #{pane_current_command} "
```

## Custom tmux Workflows

### tmux-review Function

The user has a custom `tmux-review` shell function in `~/