Features›Extensions›Current directory (OSC 7)

Current directory (OSC 7)

Category: extensions · Baseline: modern · Tags: Operating System Commands (OSC) · Specification ↗

ESC ] 7 ; file://host/path BEL

OSC 7 reports the current working directory to the terminal. The sequence is ESC ] 7 ; file://hostname/path ST. Shells emit this after each command so the terminal knows the working directory. Terminals use this to open new tabs/splits in the same directory and to make file paths in output clickable with correct relative path resolution.

How this is testedautomated
Send OSC 7 ; file://localhost/path BEL and verify the terminal accepts the current directory report.

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 10 of 12 terminals (83%). Not supported by: vt100.js, xterm.js. Part of the Modern TUI baseline. Notes: vt100.js: Not implemented — pure TypeScript emulator; xterm.js: OSC 7 not implemented in xterm.js headless.

Supported by 9 of 14 backends (64%)

Terminal Applications

Terminal	Version	Support	Notes
iTerm2	3.6.9	✓ yes
Ghostty	1.3.1	✓ yes
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
vterm	0.2.0	✓ yes
Alacritty	0.26.0	~ partial	OSC 7 CWD reporting not exposed via alacritty_terminal API
Kitty	0.40.0	~ partial	OSC 7 CWD reporting not exposed via Python batch bridge
WezTerm	0.1.0-fork.5	~ partial	OSC 7 CWD reporting not exposed via wezterm-term API
vt100.js	0.2.1	✗ no	Not implemented — pure TypeScript emulator
xterm.js	5.5.0	✗ no	OSC 7 not implemented in xterm.js headless

← Back to matrix · extensions features