ghostty-terminfo

Resolve Ghostty terminal terminfo errors on remote SSH hosts.

3|1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/soulmachine/skills --skill ghostty-terminfo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghostty-terminfo
Source: https://github.com/soulmachine/skills/tree/main/ghostty-terminfo
Command: npx skills add https://github.com/soulmachine/skills --skill ghostty-terminfo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill resolves terminfo errors when SSHing to a remote host from Ghostty terminal, improving the SSH experience by addressing missing colors, broken key bindings, or "unknown terminal type" warnings.

Core Features & Use Cases

  • Terminfo Error Resolution: Fixes terminfo errors, missing colors, broken key bindings, or "unknown terminal type" warnings.
  • Remote SSH Compatibility: Ensures Ghostty terminal functions correctly on remote hosts with missing terminfo entries.
  • Use Case: Ideal for users setting up a new remote host for use with Ghostty, encountering broken terminal behavior, or writing SSH scripts requiring Ghostty terminfo support.

Quick Start

Run the following command to check and install the terminfo on a remote host: infocmp -x xterm-ghostty \| ssh HOST tic -x -

Frequently Asked Questions about ghostty-terminfo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix the unknown terminal type error when SSHing from Ghostty?

To fix the unknown terminal type error during SSH from Ghostty, you must install the missing Ghostty terminfo entry on the remote host to restore proper terminal functionality and resolve warnings.

Why does my terminal lose colors and key bindings when connecting to a remote host?

Your terminal loses colors and key bindings because the remote host lacks the specific Ghostty terminfo definitions. Resolving this terminfo mismatch ensures correct terminal behavior and restores full SSH compatibility.

How do I install Ghostty terminfo on a remote server?

You install Ghostty terminfo on a remote server by running the command `infocmp -x xterm-ghostty | ssh HOST tic -x -` to extract and apply the local terminal definitions to the remote host environment.

Does Ghostty terminal work with remote hosts missing terminfo entries?

Ghostty terminal does not work correctly with remote hosts missing terminfo entries, resulting in broken key bindings or missing colors. You must manually transfer and install the terminfo data to ensure compatibility.

What is the best way to resolve terminfo errors for SSH scripts using Ghostty?

The best way to resolve terminfo errors for SSH scripts using Ghostty is to programmatically push the xterm-ghostty terminfo data to the remote host, ensuring the terminal environment is fully configured before script execution.