Skip to content

iTerm2 Cell Size Reporting (OSC 1337)

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

OSC 1337 ; ReportCellSize queries the terminal for the dimensions of a single character cell in pixels. The response is OSC 1337 ; ReportCellSize=height;width ST. This is essential for pixel-accurate image rendering protocols (sixel, iTerm2 inline images, kitty graphics) where applications need to know the exact pixel dimensions of cells to scale images correctly.
How this is testedautomated
Send OSC 1337 ; ReportCellSize BEL and verify the terminal responds with cell dimensions.

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 1 of 12 terminals (8%). Part of the Rich TUI baseline.

Supported by 1 of 14 backends (7%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✗ noNo ReportCellSize response
Ghostty1.3.1✗ noiTerm2-specific protocol not supported
VS Code✗ no
Warp✗ no
Cursor✗ no
Terminal.app✗ no

Headless Backends

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

BackendVersionSupportNotes
vterm0.2.0✓ yes
Alacritty0.26.0✗ noiTerm2-specific protocol not supported
Kitty0.40.0✗ noiTerm2-specific protocol not supported by kitty
vt100.js0.2.1✗ noiTerm2-specific protocol not implemented — pure TypeScript emulator
WezTerm0.1.0-fork.5✗ noiTerm2-specific protocol not supported
xterm.js5.5.0✗ noiTerm2-specific protocol not supported