Repository navigation
[Bug]: Terminal cursor leaves top and bottom edges visible during blink off phase #11402
Description
Activity
Triage
Confirmed as a cosmetic renderer bug in the shared Ghostty canvas terminal (web + desktop). Not a duplicate of #1939 (cursor position) or #7644 (stale/garbled output).
The screenshot shows two faint horizontal lines in the blank cell after an idle
%prompt during the blink off phase (light theme). That matches the focused default block cursor (cursorStyle === 1), not the unfocused hollowstrokeRect(unfocused cursors do not blink).Likely cause
renderGhosttySnapshotinapps/web/src/terminal/ghostty/renderer.tsalready repaints the cursor row on blink-off and skips the overlay (renderer.test.tsonly assertsfillTexton a mock context). The row is cleared with the samefillRectgeometry as the block cursor, usingsource-over.Cell height is integer, but row
topisoriginY + row * height. Once scrollback exists,terminalContentOriginYinapps/web/src/terminal/ghostty/surface.tsadds leftover viewport slack fromclientHeight, which is often fractional (the reporter’s screenshot has output above the prompt, so this path is active). Non-integerdevicePixelRatio/ zoom does the same.The cursor’s top/bottom antialiased edges are the row’s top/bottom edges. A later background
fillRectblends over those pixels instead of replacing them, leaving a faint cursor-colored fringe. Left/right cursor edges sit inside the row rect and get fully overwritten — which is why only the top and bottom remain.Blinking itself was restored in #5314; this looks like the off-phase erase gap that followed.
Mobile’s native Ghostty surface does not use this canvas path.
Suggested fix
In
renderGhosttySnapshot, snap row/cursor Y to the device pixel grid, or clear the dirty row with a 1 device-pixel vertical inflate /globalCompositeOperation = "copy"so the off phase replaces the previous cursor fringe. Cover it with an offscreen-canvas test at a fractionaloriginY: paint cursor on, then off, and assert the cursor cell’s first and last pixel rows match the background.No further reporter info required to implement. macOS version / display scale / zoom would only help confirm DPR, not block the fix.
Before submitting
Area
apps/desktop (integrated terminal rendered by apps/web)
Steps to reproduce
The reporter's screenshot shows a light theme and an idle
%shell prompt aftergit pullcompleted. The command is context, not an established prerequisite.Expected behavior
The cursor disappears completely during the off phase, leaving the terminal background and underlying text intact.
Actual behavior
Two faint horizontal lines remain at the top and bottom of the cursor cell when the cursor is off. The screenshot supplied by the reporter clearly shows these lines in the otherwise blank cell immediately after the prompt.
Impact
Cosmetic issue.
Version or commit
T3 Code desktop
0.0.40 (09e8de9c655a).Environment
T3 Code desktop on macOS, light theme. Exact macOS version, display scale, and zoom level were not supplied.
Investigation status
The artifact is visible in the reporter's screenshot; the blinking behavior is reporter-observed. No independent interactive reproduction or root cause has been established.
Relevant rendering code is
apps/web/src/terminal/ghostty/renderer.ts, with cursor repaint coverage inrenderer.test.ts. Existing coverage uses a mocked canvas and does not establish that no residual pixels remain after an on/off cycle on a real canvas.Searched open and closed issues for
cursor blink,terminal border, andcursor terminal. #1939 concerns cursor positioning, and #7644 concerns stale/garbled terminal output; neither specifically describes residual top/bottom cursor edges during blinking.Workaround
None verified.