Help

Notes for getting TermSurf’s terminal to behave well with other programs.

Terminfo

TermSurf reports TERM=xterm-ghostty and ships the matching terminfo entry (named xterm-ghostty, inherited from Ghostty). Locally this is installed for you, so terminal programs render correctly out of the box.

Over SSH, a remote host may not have the xterm-ghostty entry. Two shell-integration features handle this (see Features → SSH integration): with ssh-terminfo, TermSurf installs the terminfo entry on the remote host automatically; with ssh-env, it falls back to xterm-256color so programs still behave. Enable them with

. The TERM value itself is the

option.

Synchronized output

TermSurf supports the synchronized-output mode (DEC private mode 2026). A full-screen program brackets a frame of updates with the mode on, and TermSurf holds the display until the frame is complete, so the screen repaints atomically with no flicker or tearing. It is enabled by the running program, not a config option — most modern TUIs use it automatically when the terminal advertises support.

macOS

TermSurf 1.0 runs on macOS. For where the app, the web CLI, and the Roamium engine are installed (Homebrew cask paths) and how to upgrade, see Getting Started.