Appearance
Button-Event Mouse (1002)
Category: input · Tags: Xterm Extensions · Specification ↗
Button-event tracking (mode 1002) reports mouse button press, release, and motion while a button is held. More detailed than basic tracking (1000) but less verbose than all-motion tracking (1003).
How this is tested: Enable button-event mouse tracking (
CSI ? 1002 h), check getMode("mouseTracking") returns true.Analysis2026-03-26
Supported by all 8 tested terminals — universal adoption. Part of the Modern TUI baseline.
Supported by 12 of 13 backends (92%)
Terminal Applications
| Terminal | Version | Support | Notes |
|---|---|---|---|
| iTerm2 | 3.6.9 | ✓ yes | |
| Ghostty | 1.3.1 | ✓ yes | |
| VS Code | 1.112.0 | ✓ yes | |
| Warp | 0.2026.03.18.08.24.03 | ✓ yes | |
| Cursor | 2.6.21 | ✓ yes | |
| tmux | 3.6a | ✓ yes | |
| Kitty | 0.46.2 | ✓ yes | Button-event mouse tracking not exposed via headless API |
| Terminal.app | 2.15 | ✓ yes | |
| GNU Screen | 5.0.1 | ✓ yes |