Skip to content

Cursor color (OSC 12)

Category: extensions · Tags: Operating System Commands (OSC), Xterm Extensions · Specification ↗

ESC ] 12 ; color BEL
OSC 12 sets or queries the text cursor color. To set: ESC ] 12 ; color BEL where color is an X11 color specification. To query: ESC ] 12 ; ? BEL — the terminal responds with the current cursor color in rgb:RR/GG/BB format. Applications use this to make the cursor match their color scheme, or to provide visual feedback (e.g. changing cursor color to red in insert mode). Widely supported by xterm-compatible terminals.
How this is tested: Query cursor color with OSC 12 ; ? BEL, verify response matches OSC 12 ; rgb:... pattern.
Analysis2026-04-06

Supported by 3 of 8 terminals (38%). Not supported by: vterm.js, vt100.js, Alacritty, WezTerm, xterm.js. Part of the Modern TUI baseline.

Supported by 3 of 14 backends (21%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yes
Ghostty1.3.1✓ yes
Kitty0.46.2✓ yesOSC 12 cursor color query requires a real display — headless backends have no color palette to query
VS Code1.113.0? unknown
Warp0.2026.03.18.08.24.03? unknown
Cursor2.6.21? unknown
Terminal.app2.15? unknown

Headless Backends

Parser correctness only — a means the parser accepts the sequence.

BackendVersionSupportNotes
Alacritty0.26.0✗ noOSC 12 cursor color query requires a real display — headless backends have no color palette to query
vt100.js0.2.1✗ noNot implemented — pure TypeScript emulator
vterm0.2.0✗ noOSC 12 cursor color query not implemented in vterm.js
WezTerm0.1.0-fork.5✗ noOSC 12 cursor color query requires a real display — headless backends have no color palette to query
xterm.js5.5.0✗ noOSC 12 cursor color query requires a real display — headless backends have no color palette to query