Skip to content

CPL cursor preceding line (CSI F)

Category: cursor · Baseline: core · Tags: ECMA-48 Standard · Specification ↗

CSI Ps F
CPL (Cursor Preceding Line) moves the cursor to the beginning of the line N rows up. The sequence is CSI Ps F (default Ps=1). Unlike CUU, which preserves the column, CPL always sets the column to 1. CPL is the complement of CNL (Cursor Next Line, CSI E) — CNL moves down, CPL moves up, and both reset the column to the left margin.
How this is testedautomated
Position cursor at row 5, col 10, send \x1b[2F (CPL 2), verify cursor is at row 3, column 0.

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

Supported by 13 of 14 backends (93%)

Terminal Applications

TerminalVersionSupportNotes
iTerm23.6.9✓ yes
Ghostty1.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.

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