---

name: ghostty description: "Control Ghostty terminal emulator via CLI. Manage windows, tabs, splits, and configuration."

Ghostty Skill

Use the ghostty CLI to control and configure the Ghostty terminal emulator.

CLI Location

Copy/Applications/Ghostty.app/Contents/MacOS/ghostty

Or if symlinked: ghostty

Actions (IPC Commands)

Ghostty supports actions via +action flag. These control the running instance.

List available actions:

Copyghostty +list-actions

Create new window:

Copyghostty +new-window

Create new tab:

Copyghostty +new-tab

Create splits:

Copyghostty +new-split:right
ghostty +new-split:down

Navigate splits:

Copyghostty +goto-split:previous
ghostty +goto-split:next
ghostty +goto-split:up
ghostty +goto-split:down
ghostty +goto-split:left
ghostty +goto-split:right

Close current surface:

Copyghostty +close-surface

Toggle fullscreen:

Copyghostty +toggle-fullscreen

Reload configuration:

Copyghostty +reload-config

Font Management

Increase/decrease font size:

Copyghostty +increase-font-size:1
ghostty +decrease-font-size:1

Reset font size:

Copyghostty +reset-font-size

Configuration

Config file location:

Copy~/.config/ghostty/config

Show current config:

Copyghostty +show-config

List available themes:

Copyghostty +list-themes

List available fonts:

Copyghostty +list-fonts

List keybinds:

Copyghostty +list-keybinds

Launch Options

Start with specific config:

Copyghostty --config-file=/path/to/config

Start with command:

Copyghostty -e "htop"

Start in directory:

Copyghostty --working-directory=/path/to/dir

Debugging

Check version:

Copyghostty --version

Validate config:

Copyghostty +validate-config