Skip to content

OSC 633;P properties

Category: extensions · Baseline: rich · Tags: Operating System Commands (OSC), VS Code Extensions · Specification ↗

ESC ] 633 ; P ; key=value BEL

OSC 633;P sets VS Code-specific properties about the current shell state. The format is OSC 633 ; P ; key=value BEL, with VS Code-defined keys including Cwd (current working directory), IsWindows (whether running under Windows-style path semantics), and shell environment metadata used for git status and other integrations.

VS Code uses these properties to drive features like the explorer's "reveal in terminal" command (which needs to know the terminal's cwd), the terminal tab's git branch indicator, and Windows/WSL path translation. While OSC 133;P defines a similar mechanism, OSC 633;P uses VS Code-specific keys that the editor recognizes natively.

How this is testedpartial
Send OSC 633 ; P ; Cwd=/tmp BEL and verify the terminal consumes the sequence (cursor doesn't advance, terminal remains responsive).

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 Rich TUI baseline.

Supported by 11 of 14 backends (79%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yes
Ghostty1.3.1✓ yes
Terminal.app2.15✓ yes
Kitty0.46.2✓ yes
VS Code1.113.0? unknown
Warp0.2026.03.18.08.24.03? unknown
Cursor2.6.21? unknown

Headless Backends

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

BackendVersionSupportNotes
Alacritty0.26.0✓ yes
vt100.js0.2.1✓ yes
vterm0.2.0✓ yes
WezTerm0.1.0-fork.5✓ yes
xterm.js5.5.0✓ yes