Appearance
Window title (OSC 2)
ESC ] 2 ; title BELOSC 2 sets the terminal window title. The sequence is
ESC ] 2 ; title ST where ST is the string terminator (ESC \ or BEL). Used by shells to display the current directory or running command in the window title bar or tab header.
Window-title setting is one of the oldest and most widely used OSC conventions. Shells use it to show the current directory, editors use it for the open file, and multiplexers often rewrite it. Because the payload is arbitrary text, terminals must parse terminators carefully and applications should avoid emitting untrusted control characters in titles.How this is testedautomated
Send
Send
\x1b]2;Test Title\x07 (OSC 2), verify getTitle() contains "Test Title".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-05-17
Supported by 13 of 14 backends (93%)
Terminal Applications
| Terminal | Version | Support | Notes |
|---|---|---|---|
| iTerm2 | 3.6.9 | ✓ yes | |
| Ghostty | 1.3.1 | ✓ yes | |
| VS Code | ✓ yes | ||
| Warp | ✓ yes | ||
| Kitty | 0.46.2 | ✓ yes | |
| Cursor | ✓ yes | ||
| Terminal.app | ✓ yes |