• Dependencies
• Install
• Contributing
• License

Note: This plugin builds ghostty from source, which requires:

• bash, curl, tar, and POSIX utilities
• Zig compiler (version-specific to ghostty release)
• For platform-specific system dependencies see the official ghostty build documentation.
• MacOS build hasn't been tested yet.

Plugin:

asdf plugin add ghostty
# or
asdf plugin add ghostty https://github.com/ilvez/asdf-ghostty.git

ghostty:

# Show all installable versions
asdf list-all ghostty

# Install specific version
asdf install ghostty latest

# Set a version globally (on your ~/.tool-versions file)
asdf global ghostty latest

# Now ghostty commands are available
ghostty --version

• Stable releases: asdf install ghostty 1.2.3
• latest: Resolves to the most recent stable release tag
• tip: Installs from the tip tag (development snapshot)
• ref:<reference>: Build from any git reference:
  • Branch: asdf install ghostty ref:main
  • Tag: asdf install ghostty ref:v1.2.3
  • Commit: asdf install ghostty ref:abc123

You can customize the build by setting the GHOSTTY_BUILD_OPTIONS environment variable before installation:

# Example: Build with debug optimization and without themes:
export GHOSTTY_BUILD_OPTIONS="-Doptimize=Debug -Demit-themes=false"
asdf install ghostty 1.2.3

The plugin uses these default options: -Doptimize=ReleaseFast -fsys=fontconfig

Your custom options are appended to the defaults. For available build options, see the ghostty build documentation.

Contributions of any kind welcome! See the contributing guide.

Thanks goes to these contributors!

See LICENSE © Taavi Ilves