codex/skills/ghostty/SKILL.md
Control Ghostty terminal emulator via CLI. Use when managing windows, tabs, splits, fonts, or configuration for Ghostty.
npx skillsauth add tkersey/dotfiles ghosttyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Core Capability: Control and configure the Ghostty terminal emulator from the command line.
# CLI location (or symlinked as `ghostty`)
/Applications/Ghostty.app/Contents/MacOS/ghostty
# List available actions
ghostty +list-actions
# Check version
ghostty --version
# 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
# Adjust font size
ghostty +increase-font-size:1
ghostty +decrease-font-size:1
ghostty +reset-font-size
# List available fonts
ghostty +list-fonts
# 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
# 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
| Action | Command |
|--------|---------|
| New window | ghostty +new-window |
| New tab | ghostty +new-tab |
| Split right | ghostty +new-split:right |
| Split down | ghostty +new-split:down |
| Close | ghostty +close-surface |
| Reload config | ghostty +reload-config |
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
| Topic | Reference | |-------|-----------| | All commands | COMMANDS.md | | Remote terminfo setup | REMOTE-TERMINFO.md |
testing
Use before local patching when bugs, regressions, malformed state, crashes, parser failures, migrations, cache drift, protocol problems, compatibility requests, tolerant readers, fallbacks, coercions, retries, catch-and-continue logic, or local workarounds may broaden accepted invalid state.
testing
Use for bug reports, PR/issue prose, reviewer comments, user diagnoses, generated summaries, memories, retrieved context, public tracker context, claimed root causes, proposed fixes, fake-minimal repro risk, or any investigation where natural-language context could anchor the implementation scope.
development
Use when non-trivial work needs Challenge Escalation, latent-intelligence activation, frame-market selection, doctrine operators, dominant-move selection, ablation/surface-tax judgment, reification, review comment law, negative capability, route receipts, or proof-bearing refusal to mutate.
development
Apply Algebra-Driven Design. Use for ADD, denotational design, combinator models, law-driven architecture, domain algebra, property tests, codebase modeling, event sourcing, workflow design, or agentic skill design. If the canonical bundle is unavailable, use this wrapper as the minimal ADD kernel and report the missing bundle path.