← ClaudeAtlas

ghostty-terminfolisted

Use when SSHing to a remote host from Ghostty terminal and encountering terminfo errors, missing colors, broken key bindings, "unknown terminal type" warnings, or an entry that looks installed but still does not resolve
soulmachine/skills · ★ 3 · AI & Automation · score 76
Install: claude install-skill soulmachine/skills
# Ghostty Terminfo Installation ## Overview Ghostty uses `xterm-ghostty` as its `$TERM` value. Remote hosts that lack this terminfo entry will show broken terminal behavior. The fix is to transfer the terminfo from the local machine to the remote host. `tic` run as a normal user writes to `~/.terminfo`, which ncurses searches before the system directory. No sudo, and nothing to add to shell rc files. ## When to Use - Remote SSH sessions show "unknown terminal type xterm-ghostty" - Missing colors, broken backspace/arrow keys, or garbled output over SSH - Setting up a new remote host for use with Ghostty - Writing SSH scripts that should handle Ghostty terminfo automatically - The entry appears to be installed on the host, but SSH sessions are still broken ## Quick Reference | Task | Command | |------|---------| | Check if remote has terminfo | `ssh HOST 'infocmp xterm-ghostty >/dev/null 2>&1'` | | Install terminfo on remote | `infocmp -x xterm-ghostty \| ssh HOST tic -x -` | | One-liner check + install | `ssh HOST 'infocmp xterm-ghostty >/dev/null 2>&1' \|\| infocmp -x xterm-ghostty \| ssh HOST tic -x -` | | Verify after install | `ssh HOST 'infocmp -x xterm-ghostty 2>/dev/null \| grep -q Smulx && echo OK'` | | Show the terminfo search path | `ssh HOST 'infocmp -D'` | ## Implementation ### Local Install If you're already on the machine, just pipe it directly to `tic`: ```bash infocmp -x xterm-ghostty | tic -x - ``` ### One-Time Install ```bash infocmp -x xterm-gho