Terminal & Shell — Ghostty, Starship, Zsh, Fish

Ghostty (GPU terminal), Starship (prompt), the Zsh + Fish setup with eza, fzf, zoxide, Atuin, and the four-plugin fish-like Zsh experience.

The terminal stack: a GPU terminal, a single prompt shared by both shells, and Zsh + Fish kept in lockstep so you can switch at any time.

Ghostty

GPU-accelerated terminal. Tokyo Night theme, JetBrains Mono Nerd Font, tabs, splits, clipboard.

brew install --cask ghostty
mkdir -p ~/.config/ghostty
ln -sf ~/dotfiles/ghostty/config ~/.config/ghostty/config

Tabs

Splits

Inactive splits are dimmed (0.7 opacity), mouse-hover switches focus.

Power

Notifications: any command that runs > 10s in an unfocused tab triggers a macOS notification on completion.

Misc

Option key acts as Alt (vim/fish Alt-bindings work). Cursor hides while typing.

Starship

Two-line bracket prompt with live tech-stack, git, command status, monorepo detection, and a dedicated Claude Code statusline. Tokyo Night palette throughout.

Prompt layout (illustrative):

╭─ ~/dots/sketchybar  main ●✚⇡ +12 -3      ⬢ Nx ⚡ Turbo   v22   $2.34          10:42
╰─  2.3s ✗1 ❯

Tech stack modules

Each module renders only inside a project of that language — your daily prompt stays clean.

Git indicators

Monorepo badges

Badges stack — e.g. an Nx + pnpm repo lights up both. Cargo workspace uses a grep check, the rest are pure file/folder detection (zero cost outside monorepos).

Command status

Claude Code statusline

Starship doubles as Claude Code’s statusline via the starship statusline claude-code profile. Renders the active model, a context-window gauge, session cost, and the git branch.

Rendered output (illustrative):

󰚩 Opus 4.7 (1M)  ████░░░░░░ 38%   $2.34   main ✓

# Auto-configured by install.sh — answer "yes" to the Starship statusline prompt.
# Or merge manually with jq (preserves existing keys):
jq '.statusLine = {type: "command", command: "starship statusline claude-code"}' \
 ~/.claude/settings.json | sponge ~/.claude/settings.json

brew install starship
ln -sf ~/dotfiles/starship/starship.toml ~/.config/starship.toml

Shell tools

lsd · Starship · Fastfetch · CodexBar.

# lsd — modern ls replacement
brew install lsd
alias ls='lsd'
alias ll='lsd -la'
alias lt='lsd --tree'

# fastfetch — system info (run on demand, not auto-loaded)
brew install fastfetch
fastfetch

CodexBar — AI token usage tracker. Install from github.com/steipete/CodexBar, then log in to Claude and Gemini via the menu bar app. Query usage with codexbar usage --provider claude --format json.

Zsh

Default shell on macOS. Starship prompt, fzf, zoxide, eza, Atuin history, and a fish-like input experience via four zsh plugins.

ln -sf ~/dotfiles/zsh/.zshrc ~/.zshrc

What’s included

Eza

Every ls-family alias is driven from a single $EZA_BASE variable plus a Tokyo-Night palette. ls is bound to the long view (same body as ll); plain grid is reachable via lG.

Shared base flags ($EZA_BASE):

--icons=always                # nerd-font glyphs
--group-directories-first     # folders rise to the top
--classify=auto               # /, *, @ markers on a TTY
--color=always                # keep colour through pagers
--color-scale=all             # gradient on size + age columns
--color-scale-mode=gradient   # smooth gradient, not buckets
--hyperlink                   # OSC-8 clickable paths

Tokyo-Night palette ($EZA_COLORS) — eza uses LS_COLORS syntax. About 80 rules cover file-type metadata, permissions, git status, and per-extension hues. Reorder freely — first match wins.

Plugins

Four plugins make zsh feel like fish. Loading order matters — fzf-tab first (touches compdef), syntax-highlighting second-to-last, history-substring-search dead last.

The brew packages are in the Brewfile. fzf-tab has no brew formula — install.sh clones it idempotently to ~/.local/share/zsh/fzf-tab.

brew install zsh-autosuggestions zsh-syntax-highlighting zsh-history-substring-search
git clone --depth=1 https://github.com/Aloxaf/fzf-tab ~/.local/share/zsh/fzf-tab

Aliases

Per-project shortcuts (lumo, envpilot.dev, …) live in ~/.config/dotfiles/aliases.local.{sh,fish} — sourced by both shellrcs if present, never committed.

brew install fzf zoxide eza bat starship atuin \
 zsh-autosuggestions zsh-syntax-highlighting zsh-history-substring-search
git clone --depth=1 https://github.com/Aloxaf/fzf-tab ~/.local/share/zsh/fzf-tab

Fish

Friendly interactive shell. Aliases, eza palette, git function, and project shortcuts mirror zsh one-to-one. Autosuggestions / syntax-highlighting / history-substring-search are built-in to fish — no plugins needed.

brew install fish
mkdir -p ~/.config/fish
ln -sf ~/dotfiles/fish/config.fish ~/.config/fish/config.fish

# Set as default shell (optional)

echo $(which fish) | sudo tee -a /etc/shells
chsh -s $(which fish)

What’s included

Aliases (one-to-one with zsh)

Where to go next

• Desktop & WM — SketchyBar, AeroSpace, OmniWM.
• Apps & tools — the rest of the CLI + GUI inventory.
• Symlinks — how each config above lands in ~/.config/.