Ghostty Ghost 👻

A command-line tool to convert Kitty and Alacritty terminal configurations to Ghostty format.

Features

• Convert Kitty terminal configurations to Ghostty format
• Convert Alacritty terminal configurations to Ghostty format
• Automatic backup of existing configuration files
• Interactive mode for easy configuration selection
• Support for theme conversion
• Alphabetically sorted configuration output
• Automatic color palette mapping

Installation

Download the latest release from the releases page.

• Linux
• MacOS
• Windows

MacOS prefered install method is using brew:

# Add the tap repository
brew tap gambithunt/tools

# Install the package
brew install ghostty-ghost

# run ghostty-ghost
ghostty-ghost --help

MacOS releases are also provided as Universal binaries (labeled as Darwin), compatible with both Apple Silicon and Intel processors. releases page.

Usage

Interactive Mode

Simply run the tool without any arguments:

ghostty-ghost

This will:

• Detect available terminal configurations
• Let you select which configuration to convert
• Convert and save the configuration to Ghostty format

Command Line Mode

ghostty-ghost [options]

Options:

• -f, --from Terminal to convert from ( kitty, alacritty)
• -s, --source Path to source terminal config file
• -t, --target Path to target ghostty config file

Example:

ghostty-ghost -f kitty -s ~/.config/kitty/kitty.conf -t ~/.config/ghostty/config

Additional Features

• Automatically creates backup files (.bak extension)
• Converts color schemes and themes
• Maintains comments for unmapped settings
• Creates target directory if it doesn't exist
• Provides colorized output for warnings and errors

Configuration Path Defaults

• Kitty: ~/.config/kitty/kitty.conf
• Alacritty: ~/.config/alacritty/alacritty.toml
• Ghostty: ~/.config/ghostty/config

Contributing

Contributions are welcome! Feel free to submit issues and pull requests.

License

This project is open source and available under the MIT License.