mcpField
G
ghostty

ghostty

github.com/dicklesworthstoneDevelopment7362 installsUpdated 8w ago
Repository

About ghostty

ghostty is a skill for controlling and configuring the Ghostty terminal emulator from the command line. It covers window and tab management, font and configuration actions, launch options, and remote SSH terminfo troubleshooting.

Key features

  1. 01Manage windows, tabs, and splits
  2. 02Adjust font size and list fonts
  3. 03Show, validate, and reload configuration
  4. 04Launch with a config, command, or working directory
  5. 05Address remote SSH terminfo issues

Use cases

  1. 01Create terminal windows and splits with commands
  2. 02Adjust fonts or inspect Ghostty configuration
  3. 03Launch Ghostty in a chosen directory or with a command
  4. 04Resolve terminal character issues in SSH sessions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ghostty

After installing, type/ghosttyin Claude Code to confirm it loaded.

Bundled filesreferences/COMMANDS.mdreferences/REMOTE-TERMINFO.md

Details

From the project README

Ghostty CLI

Core Capability: Control and configure the Ghostty terminal emulator from the command line.

Quick Start

# CLI location (or symlinked as `ghostty`)
/Applications/Ghostty.app/Contents/MacOS/ghostty

# List available actions
ghostty +list-actions

# Check version
ghostty --version

THE EXACT PROMPT — Window/Tab Management

# New window
ghostty +new-window

# New tab
ghostty +new-tab

# Splits
ghostty +new-split:right
ghostty +new-split:down

# Navigate splits
ghostty +goto-split:up
ghostty +goto-split:down
ghostty +goto-split:left
ghostty +goto-split:right

# Close current surface
ghostty +close-surface

# Toggle fullscreen
ghostty +toggle-fullscreen

THE EXACT PROMPT — Font Management

# Adjust font size
ghostty +increase-font-size:1
ghostty +decrease-font-size:1
ghostty +reset-font-size

# List available fonts
ghostty +list-fonts

THE EXACT PROMPT — Configuration

# Config file: ~/.config/ghostty/config

# Show current config
ghostty +show-config

# Validate config
ghostty +validate-config

# Reload config (live)
ghostty +reload-config

# List themes/keybinds
ghostty +list-themes
ghostty +list-keybinds

Launch Options

# Start with specific config
ghostty --config-file=/path/to/config

# Start with command
ghostty -e "htop"

# Start in directory
ghostty --working-directory=/path/to/dir

Essential Commands

ActionCommand
New windowghostty +new-window
New tabghostty +new-tab
Split rightghostty +new-split:right
Split downghostty +new-split:down
Closeghostty +close-surface
Reload configghostty +reload-config

Troubleshooting: Remote SSH

Problem: Seeing [57414u garbage when pressing numpad Enter over SSH.

Quick fix:

infocmp -x xterm-ghostty | ssh user@server 'mkdir -p ~/.terminfo && tic -x -o ~/.terminfo -'

Fallback (no terminfo access):

alias myserver='TERM=xterm-256color ssh user@myserver'

Full guide: REMOTE-TERMINFO.md

References

TopicReference
All commandsCOMMANDS.md
Remote terminfo setupREMOTE-TERMINFO.md

Comments

Markdown supported