Mouse-mode pane resizing versus Ctrl-b prefix navigation for reliable switching in limited-terminal SSH sessions

Reliability of Mouse Mode in Terminal Configurations

Mouse mode reliably supports pane resizing without interfering with command-mode actions only in terminals that support xterm-compatible mouse tracking (specifically DECSET 1000/1002/1003/1006). In these environments, the terminal emulator handles the mouse events and sends the appropriate escape sequences that tmux recognizes as gestures rather than keyboard input.

In limited-terminal SSH sessions—such as those using TERM=vt100 or connections routed through older multiplexers that do not forward mouse reporting—mouse mode is unreliable. In these cases, dragging the mouse may not resize the pane and may instead inject stray escape sequences into the input buffer. These sequences can interfere with Ctrl-b prefix navigation, leading to delayed responses or missed commands.

Impact of Persistent Configuration Across Environments

The set -g mouse on directive in ~/.tmux.conf creates a consistency gap when moving between high-capability local terminals and limited remote SSH environments. Because the setting is persistent, tmux will attempt to process mouse events regardless of the current terminal's capabilities.

• Capable Terminals: Seamless interaction between mouse resizing and prefix keys.
• Limited Terminals: Potential for input buffer pollution, where the terminal sends raw characters that tmux cannot interpret as mouse events, potentially disrupting the timing of prefix-key sequences.

Runtime Toggling and Copy-Mode State

Runtime toggling of the mouse option can be performed without corrupting the terminal state or existing copy-mode selections. If you are in copy-mode and have a selection highlighted, executing the toggle command will not clear that selection; the highlight remains until you manually exit copy-mode.

Safe Runtime Toggling Commands

To toggle mouse mode during a session without restarting the server, use the following commands from the tmux command prompt (Ctrl-b :):

set -g mouse on  # Enable mouse resizing and selection
set -g mouse off # Disable mouse to prevent interference in limited terminals

Verification Steps

1. Verify Support: Enable mouse mode and attempt to drag a pane border. If characters appear in your shell prompt instead of the pane resizing, your terminal lacks the necessary mouse reporting.
2. Verify Selection Persistence: Enter copy-mode (Ctrl-b [), select text, and run set -g mouse off. Confirm the selection remains highlighted.

Diagnostic Note: To provide a more specific recommendation for your environment, please specify the $TERM environment variable value on both your local machine and the remote SSH host.