Skip to content

iTerm2 Cell Size Reporting (OSC 1337) โ€‹

Category: extensions ยท Tags: Operating System Commands (OSC), Iterm2 ยท 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 tested: Send OSC 1337 ; ReportCellSize BEL and verify the terminal responds with cell dimensions.
Analysis2026-03-26

Supported by 1 of 8 terminals (13%). Part of the Rich TUI baseline. Notes: Ghostty: iTerm2-specific protocol not supported; Kitty: iTerm2-specific protocol not supported by kitty.

Supported by 2 of 13 backends (15%)

Terminal Applications โ€‹

TerminalVersionSupportNotes
iTerm23.6.9โœ“ yes
Ghostty1.3.1โœ— noiTerm2-specific protocol not supported
VS Code1.112.0โœ— noNo OSC 1337 ReportCellSize response
Warp0.2026.03.18.08.24.03โœ— noNo OSC 1337 ReportCellSize response
Cursor2.6.21โœ— noNo OSC 1337 ReportCellSize response
tmux3.6aโœ— noiTerm2-specific protocol not supported by tmux
Kitty0.46.2โœ— noiTerm2-specific protocol not supported by kitty
Terminal.app2.15โœ— noNo OSC 1337 ReportCellSize response
GNU Screen5.0.1โœ— noiTerm2-specific protocol not supported by Screen

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
vt1000.2.1โœ— noiTerm2-specific protocol not implemented โ€” pure TypeScript emulator
WezTerm0.1.0-fork.5โœ— noiTerm2-specific protocol not supported

Powered by Termless
Playwright for Terminals