Terminal
A modern macOS terminal setup, step by step: Ghostty, Zsh, Starship and the tools that make the command line fast.
The Ideas Behind This Setup
A great terminal does the remembering for you: where your projects live, what you ran last week, which branch you’re on. Each tool below removes one thing you’d otherwise have to type or recall.
- A fast, native terminal. Ghostty draws with the GPU and uses real macOS tabs and splits, so it feels instant and fits in with the rest of your Mac.
- A Nerd Font. JetBrains Mono Nerd Font is the same font as your editor, plus thousands of icons that tools use for files, folders and git status.
- A prompt that shows context. Starship shows your folder, git branch and status, the language versions in the current project, and how long the last command took, but only when it matters.
- Fuzzy everything. fzf turns any list (files, folders, history) into a searchable picker. You type a few letters instead of exact paths.
- Navigation that learns. zoxide remembers the folders you use most, so
cd apijumps straight to your API project from anywhere. - History as a database. Atuin stores every command with its folder, exit code and duration, and finds any of them in a moment.
- Modern replacements. eza, bat, ripgrep and fd are faster, friendlier versions of
ls,cat,grepandfind. - Versions per project. mise installs and switches Java, Node and Python versions per folder, so each project uses exactly what it needs.
1. Install Everything
If you don’t have Homebrew yet, install it first. When it finishes, run the two commands it prints under “Next steps” so brew works in new windows.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Then install the terminal and the font:
brew install --cask ghostty font-jetbrains-mono-nerd-fontAnd the command-line tools, all at once:
brew install starship zsh-autosuggestions zsh-syntax-highlighting \
fzf zoxide atuin eza bat ripgrep fd git-delta lazygit \
mise fastfetch btop tlrc jq- starship: the prompt.
- zsh-autosuggestions and zsh-syntax-highlighting: grey suggestions from your history as you type (press → to accept), and commands colored green when valid, red when not.
- fzf, zoxide and atuin: fuzzy search, smart
cd, and searchable history. - eza, bat, ripgrep (
rg) and fd: betterls,cat,grepandfind. - git-delta and lazygit: readable diffs and a full git interface in the terminal.
- mise: Java, Node and Python versions per project.
- fastfetch, btop, tlrc (
tldr) and jq: a system summary, a system monitor, short command examples, and JSON processing.
2. Configure Ghostty
Create the config file and open it:
mkdir -p ~/.config/ghostty && touch ~/.config/ghostty/config && open -e ~/.config/ghostty/configPaste this in, save, and press ⌘⇧, in Ghostty to reload:
# Font: same as your editor, with icons
font-family = JetBrainsMono Nerd Font
font-size = 14
adjust-cell-height = 20%
# Theme: follows macOS light and dark mode
theme = light:Catppuccin Latte,dark:Catppuccin Mocha
# Window
window-padding-x = 14
window-padding-y = 10
window-padding-balance = true
macos-titlebar-style = tabs
background-opacity = 0.97
# Behavior
cursor-style = bar
mouse-hide-while-typing = true
copy-on-select = clipboard
confirm-close-surface = false
macos-option-as-alt = true
# Drop-down terminal from any app: press Cmd and the backtick key
keybind = global:cmd+grave_accent=toggle_quick_terminal- Font and spacing: JetBrains Mono Nerd Font at 14px, with 20% extra line height so output is easier to scan.
- Theme: Catppuccin Latte in light mode and Mocha in dark mode, matching your editors.
- Option as Alt: makes shortcuts like
Option+C(jump to a folder) work. - Copy on select: selecting text copies it, no
⌘Cneeded. - Quick terminal: a terminal that drops down from the top of the screen in any app. macOS will ask you to allow Ghostty under System Settings → Privacy & Security → Accessibility the first time.
Theme names changed between Ghostty versions. If the theme doesn’t apply, run ghostty +list-themes and copy the exact Catppuccin names it shows.
3. Set Up Zsh
Back up your current config first with cp ~/.zshrc ~/.zshrc.backup. Then open ~/.zshrc and replace its contents with this:
# ── History ─────────────────────────────────────
HISTFILE=~/.zsh_history
HISTSIZE=100000
SAVEHIST=100000
setopt SHARE_HISTORY HIST_IGNORE_ALL_DUPS HIST_REDUCE_BLANKS
# ── Completion ──────────────────────────────────
autoload -Uz compinit && compinit
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}' # case-insensitive
zstyle ':completion:*' menu select # arrow through matches
# ── Fuzzy finder: fd for speed, bat and eza for previews ──
export FZF_DEFAULT_COMMAND='fd --type f --hidden --exclude .git'
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
export FZF_CTRL_T_OPTS="--preview 'bat --color=always --style=numbers --line-range=:200 {}'"
export FZF_ALT_C_COMMAND='fd --type d --hidden --exclude .git'
export FZF_ALT_C_OPTS="--preview 'eza --tree --level=2 --color=always {}'"
source <(fzf --zsh)
# ── Tools ───────────────────────────────────────
eval "$(starship init zsh)" # the prompt
eval "$(zoxide init zsh --cmd cd)" # cd learns your favorite folders
eval "$(atuin init zsh --disable-up-arrow)" # Ctrl-R searches all your history
eval "$(mise activate zsh)" # per-project Java, Node and Python
# ── Better defaults ─────────────────────────────
export BAT_THEME="ansi" # bat uses the terminal's colors
alias ls='eza --icons --group-directories-first'
alias ll='eza -lah --icons --git --group-directories-first'
alias tree='eza --tree --level=2 --icons'
alias cat='bat --paging=never'
alias lg='lazygit'
# ── Plugins (syntax highlighting must load last) ──
source "$HOMEBREW_PREFIX/share/zsh-autosuggestions/zsh-autosuggestions.zsh"
source "$HOMEBREW_PREFIX/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"- History: keeps 100,000 commands, shared between all open tabs, without duplicates.
- Completion: Tab completion that ignores upper and lower case, with a menu you can arrow through.
- fzf: uses
fdto find files quickly, and shows a preview of files (with bat) and folders (with eza) as you search. - zoxide: replaces
cd. Normal paths still work, and short names jump to the best match.cdiopens an interactive picker. - Atuin: takes over
Ctrl+R. The up arrow keeps its normal behavior. - Aliases:
ls,llandtreeshow icons and git status;catadds syntax highlighting;lgopens lazygit.
Bring your existing history into Atuin, then reload the shell:
atuin import auto
exec zsh4. Customize the Prompt
Starship works with no config, but a two-line prompt keeps long paths from pushing your typing to the right. Create the file:
open -e "$(mkdir -p ~/.config && touch ~/.config/starship.toml && echo ~/.config/starship.toml)""$schema" = 'https://starship.rs/config-schema.json'
# Line 1: where you are and what's going on. Line 2: the arrow you type after.
format = """
$directory$git_branch$git_status$java$python$nodejs$cmd_duration
$character"""
[directory]
truncation_length = 3
style = "bold cyan"
[git_branch]
format = "on [$branch]($style) "
style = "bold purple"
[git_status]
format = '([$all_status$ahead_behind]($style) )'
[cmd_duration]
min_time = 2000 # only show for commands slower than 2 seconds
format = "took [$duration]($style) "
[character]
success_symbol = "[❯](bold green)"
error_symbol = "[❯](bold red)"The first line shows the folder, the git branch and status, the Java, Python or Node version (only inside a project that uses it), and how long a slow command took. The arrow on the second line turns red when the last command failed.
Want icons for every language? Run starship preset nerd-font-symbols -o ~/.config/starship.toml to start from Starship’s ready-made icon preset instead.
5. Better Git
Make delta the viewer for every diff, with side-by-side changes and syntax highlighting:
git config --global core.pager delta
git config --global interactive.diffFilter "delta --color-only"
git config --global delta.navigate true
git config --global delta.side-by-side true
git config --global merge.conflictStyle zdiff3git diff,git showandgit log -pnow show side-by-side, highlighted changes. PressnandNto jump between files.zdiff3shows the original code in the middle of merge conflicts, so you can see what both sides changed.- Type
lgto open lazygit: stage individual lines, commit, switch branches, rebase and push, all with single keys.
6. Java, Node and Python Versions
Set your default versions once:
mise use --global java@21 node@lts python@3.12Inside a project that needs something different, run mise use java@17. mise writes a mise.toml file in that folder and switches versions automatically whenever you cd into it. Commit that file and your teammates get the same versions.
Daily Shortcuts
- `⌘` and the backtick key: open the drop-down quick terminal from any app.
- `⌘D` and `⌘⇧D`: split the Ghostty window right or down.
- `Ctrl` + `R`: search everything you’ve ever run, with Atuin.
- `Ctrl` + `T`: fuzzy-find a file and paste its path, with a preview.
- `Option` + `C`: fuzzy-find a folder and jump into it.
- `cd api`: jump to the folder you use most that matches “api”.
- `ll` and `tree`: list files with icons and git status.
- `rg "TODO"` and `fd config`: search file contents and file names, fast.
- `lg`: open lazygit.
- `tldr tar`: short, practical examples for any command.
- `btop` and `fastfetch`: a live system monitor, and a snapshot of your machine.
Using Warp instead of Ghostty? Skip step 2. Everything else works in Warp too, and Warp has its own history search, so you can leave Atuin out.