Configuration

Terminal Configuration

All terminal settings — font, colors, cursor, keybindings — are managed via Ghostty's config file:

~/.config/ghostty/config

Kytos reads this file at startup and whenever it changes. Use the Settings window → "Open Ghostty Config" for quick access.

Common Settings

# Font
font-family = "Berkeley Mono"
font-size = 13

# Colors (use a Ghostty theme)
theme = "catppuccin-mocha"

# Cursor
cursor-style = block
cursor-style-blink = false

# Keybindings
keybind = cmd+d=new_split:right
keybind = cmd+shift+d=new_split:down

See the Ghostty documentation for the full configuration reference.

Kytos-Specific Preferences

Kytos-specific UI preferences (horizontal margin, etc.) are stored in UserDefaults and configurable via the Settings window. These are separate from the Ghostty config.

Shell Integration

Shell integration is bundled inside Kytos.app:

Kytos.app/Contents/Resources/
  terminfo/78/xterm-ghostty         # Sentinel for resource detection
  ghostty/shell-integration/        # bash, zsh, fish, elvish, nushell scripts

Ghostty's shell integration injects automatically when the TERM environment variable is xterm-ghostty. No manual sourcing required.