vmux
Input

Mouse & Selection

Select text, copy to clipboard, and interact with links.

Selecting Text

Long-press and drag to select text in the terminal. Selected text is automatically copied to the system clipboard when you release.

  • Long-press — start selecting at the touched cell
  • Drag — extend the selection across characters and lines
  • Release — copies the selection to the clipboard
  • Tap — clears an active selection
  • Cmd+C — copies the selection and clears it

vmux automatically detects URLs in terminal output. Tap a link to open it in your default browser. Links are highlighted when your gaze hovers over them.

Mouse Reporting

Terminal apps like vim, htop, and tmux can request mouse input. vmux detects this automatically — when an app enables mouse mode:

  • Tap sends a click (press + release) at the tapped cell
  • Drag sends press, drag, and release events — useful for scrolling or resizing panes in tmux
  • Hover (eye gaze) sends motion events if the app requests all-motion tracking

Mouse mode is controlled by the remote application. When you exit the app (e.g., quit vim), normal selection behavior resumes automatically.

Long-press always starts a text selection, even when mouse mode is active.

Gaze Tracking

On Apple Vision Pro, your eye gaze acts as a pointer. vmux uses gaze for:

  • Window focus — looking at a window makes it the active input target
  • Link highlighting — URLs under your gaze are visually highlighted
  • Mouse hover — in mouse-reporting mode, gaze position is reported as mouse motion