Ghostty Terminal with Superpowers! (BETA)

Ghostty Terminal with Zsh, a simple and awesome UI, advanced autocomplete, fzf, command snippets/history, and much more.

Requirements

• macOS, Ubuntu, or Arch / Arch-based OS with one of these package managers: brew, pacman, or snap+apt

Install

1. Clone the repository

   git clone git@github.com:iocron/ghostty-superpowers.git ~/.ghostty-superpowers

2. Set up the installer

   cd ~/.ghostty-superpowers && chmod +x install.sh

3. Start the Installer and pick a profile when prompted:

   ./install.sh

   • Minimal - Ghostty + config, zsh, the zsh plugins, fzf, and the Hack Nerd Font.
   • Full - everything in Minimal plus extra tools (btop, fd, helix, lazygit, ripgrep, tldr, …) and the AI stack (Ollama + a default model, pulled for you).
4. (Re)start Ghostty (on macOS located in /Applications/Ghostty.app)

Enjoy your new Ghostty Experience :)

Features

• Ghostty Terminal with Blockview Gadgets
• Advanced Snippet-/Historysearch and Autocomplete
• AI-Powered LLM Completion (type # followed by text and press Tab or Enter)
• Directory Jump with numeric shortcuts (0-9) to hop between your most-used directories (type 0 to show the ranked list)
• Quick browser websearch (e.g. s <query>)
• Zsh with a built-in framework (prompt, completion, keybindings, git prompt)
• Other helper aliases and functions can be listed with alias / functions

How to use the Snippet-/History Autocomplete Feature

Simply create/edit the file ~/.ghostty-superpowers/data/snippets.txt and add snippets in the form:

COMMAND ## NAME/TITLE ## DESCRIPTION..

For example: echo "123" ## Echo example ## Outputs text
(or use one of the example files data/snippets.examples-long.txt)

When you restart Ghostty, you should see your new commands in the history/reverse search and while typing (due to autocomplete). If this still doesn't work, delete the file /tmp/.ghostty_snippets_lastrun and restart Ghostty again.

How to use the AI Auto-Completion Feature

The Full installation sets up ollama and the default model out of the box. With a Minimal install, install ollama yourself (https://ollama.com/) and pull a model: ollama pull gemma4:e2b (or gemma4:e2b-mlx on macOS).

To use a different model, pull it and set GHOSTTY_SUPERPOWERS_OLLAMA_MODEL in ~/.ghostty-superpowers/.env (or your zsh profile), e.g. GHOSTTY_SUPERPOWERS_OLLAMA_MODEL=gemma4:e2b

Then, in a new pane or session, use it two ways - press Tab or Enter after typing:

• Generate a command: start the line with # and describe what you want, e.g. # list files by size.
• Modify a command: write the command, then # and an instruction, e.g. echo 123 # change the string to hello world → echo "hello world".

Preview of some Features

FAQ

Prefer oh-my-zsh?

Set GHOSTTY_SUPERPOWERS_USE_OMZ=1 in your ~/.zshrc (before init.zsh is sourced) to load your existing oh-my-zsh in place of the built-in framework - the rest of ghostty-superpowers (plugins, fzf, snippets, AI completion) still loads either way.

Don't have one of the supported package managers?

Set up manually: install Ghostty, zsh, fzf, and a Hack Nerd Font; clone zsh-autosuggestions and zsh-syntax-highlighting into plugins_external/; add config-file = ~/.ghostty-superpowers/data/ghostty-config to ~/.config/ghostty/config; source ~/.ghostty-superpowers/init.zsh in ~/.zshrc; then restart Ghostty.