Appearance
Alt-scroll mouse wheel (?1007)
CSI ? 1007 h/lDECSET 1007 enables alternate scroll mode: when the alternate screen buffer is active, mouse wheel events are translated into cursor up/down key presses (or the equivalent application keypad sequences) instead of being reported as mouse events. The sequence is
ESC [ ? 1007 h to enable, ESC [ ? 1007 l to disable.
This lets users scroll TUI applications that don't natively handle mouse events (like less, man, or vim in default mode) by simply using the mouse wheel — the terminal converts the wheel motion into the same arrow-key sequences a keyboard press would produce. When disabled, mouse wheel events in the alt screen are sent as proper mouse reports instead.How this is testedautomated
Send
Send
\x1b[?1007h (DECSET 1007), verify the sequence is consumed without breaking subsequent terminal output. Headless backends rarely track this mode, so verification is partial.The same probe runs against headless backends (via Termless) and real terminal apps (via a daemon launched in each terminal). This lets us distinguish parser correctness from rendering correctness.
Analysis2026-04-06
Supported by all 9 tested terminals — universal adoption. Part of the Modern TUI baseline.
Supported by 12 of 14 backends (86%)
Terminal Applications
| Terminal | Version | Support | Notes |
|---|---|---|---|
| iTerm2 | 3.6.9 | ✓ yes | DECRPM: mode reset |
| Ghostty | 1.3.1 | ✓ yes | DECRPM: mode set |
| VS Code | ✓ yes | ||
| Warp | ✓ yes | ||
| Cursor | ✓ yes | ||
| Terminal.app | ✓ yes |
Headless Backends
Parser correctness only — a ✓ means the parser accepts the sequence.
| Backend | Version | Support | Notes |
|---|---|---|---|
| Alacritty | 0.26.0 | ✓ yes | |
| Kitty | 0.40.0 | ✓ yes | |
| vt100.js | 0.2.1 | ✓ yes | |
| WezTerm | 0.1.0-fork.5 | ✓ yes | |
| vterm | 0.2.0 | ✗ no | Alt-scroll mode not implemented in vterm.js |
| xterm.js | 5.5.0 | ✗ no | Alt-scroll mode not tracked by xterm.js |