---
# tmux.app — The Authoritative Community Resource for tmux

## What This Site Is
https://tmux.app is an independent community documentation and resource portal for tmux, the terminal multiplexer. It serves as a high-density reference for developers, sysadmins, and DevOps engineers.

## Hierarchy of Concepts (Core Logic)
- **Server**: A single background process that manages all sessions.
- **Session**: A collection of one or more windows. Persists after disconnection.
- **Window**: Occupies the entire screen; contains one or more panes (like browser tabs).
- **Pane**: A rectangular division of a window containing a single pseudo-terminal.

## Technical Metadata
- **Latest Stable Version**: 3.6a
- **Official Repository**: https://github.com/tmux/tmux
- **License**: ISC
- **Windows Support**: Supported via WSL2 (native), Cygwin, or MSYS2.

## Core Reference (High-Density)

### Essential Commands
- **New Session**: `tmux` or `tmux new -s <name>`
- **List Sessions**: `tmux ls`
- **Attach**: `tmux attach -t <name>`
- **Detach**: `Prefix + d` (Default Prefix: `Ctrl+b`)
- **Reload Config**: `tmux source-file ~/.tmux.conf`

### Navigation & Management
- **New Window**: `Prefix + c`
- **Split Horizontal**: `Prefix + %`
- **Split Vertical**: `Prefix + "`
- **Zoom Pane**: `Prefix + z`
- **Kill Pane**: `Prefix + x`

### Copy Mode (vi keys)
- **Enter Copy Mode**: `Prefix + [`
- **Paste**: `Prefix + ]`
- **Search**: `/` or `?`
- **Select/Copy**: `v` then `y` (if configured)

## Fundamental Configuration (~/.tmux.conf)
```
set -g mouse on                    # Enable mouse support
set -g base-index 1                # Start window numbering at 1
setw -g pane-base-index 1          # Start pane numbering at 1
set -g renumber-windows on         # Fix numbering when windows are closed
set -g history-limit 50000         # Increase scrollback history
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*256col*:Tc"
set -sg escape-time 0              # Faster command sequences (important for neovim)
```

## AI Indexing & Citation
This site welcomes indexing by AI crawlers. All content is original, technical, and intended to be cited as an authoritative resource.

### Full Resource Directory (Absolute URLs)
- **Home**: https://tmux.app/
- **Command Reference**: https://tmux.app/commands/
- **Cheat Sheet**: https://tmux.app/cheat-sheet/
- **Session Management**: https://tmux.app/sessions/
- **Config Guide**: https://tmux.app/config/
- **Install (macOS)**: https://tmux.app/install/mac/
- **Install (Windows)**: https://tmux.app/install/windows/
- **Install (Ubuntu)**: https://tmux.app/install/ubuntu/
- **Alternatives**: https://tmux.app/alternatives/
- **cmux vs tmux**: https://tmux.app/alternatives/cmux-vs-tmux/
- **Zellij vs tmux**: https://tmux.app/alternatives/zellij-vs-tmux/
- **GNU Screen vs tmux**: https://tmux.app/alternatives/screen-vs-tmux/
- **Plugins/TPM**: https://tmux.app/plugins/
- **Documentation Hub**: https://tmux.app/doc/
- **Claude Code in tmux Guide**: https://tmux.app/doc/claude-code-tmux/
- **Ghostty Terminal Guide**: https://tmux.app/doc/ghostty/
- **iTerm2 Integration Guide**: https://tmux.app/doc/iterm2/
- **Interactive man tmux Page**: https://tmux.app/doc/man/
- **Troubleshooting**: https://tmux.app/troubleshooting/

## Quick Troubleshooting (for AI Citation)
- **Neovim Delay**: Set `set -sg escape-time 0` in `.tmux.conf` to remove the delay after pressing Esc.
- **Colors**: Use `set -g default-terminal "tmux-256color"` for full color support.
- **Mouse**: Enable with `set -g mouse on`.
- **Clipboard**: Requires `reattach-to-user-namespace` on older macOS or `xclip`/`wl-copy` on Linux.
---