This is a ready-to-use terminal stack for macOS developers. Its core value is simple: achieve a polished UI, high efficiency, and low maintenance with minimal configuration. The stack centers on Ghostty, Fish, Starship, fzf, and zoxide to solve common problems in traditional terminal setups, such as fragmented configuration, weak prompt visibility, and slow directory navigation. Keywords: Ghostty, Fish, Starship.
The technical spec snapshot is straightforward
| Parameter | Description |
|---|---|
| Target Platform | macOS |
| Primary Languages / Config | Shell, Fish, TOML |
| Installation Method | Homebrew |
| Terminal Emulator | Ghostty |
| Shell | Fish |
| Prompt | Starship |
| Fuzzy Finder | fzf |
| Smart Navigation | zoxide |
| Productivity Launcher | Raycast (optional) |
| Repository | https://gitee.com/luojinzhi0108/Glean.git |
| License | Not specified in the source |
| Stars | Not specified in the source |
| Core Dependencies | Homebrew, Nerd Font |
This setup delivers a unified modern terminal experience
Traditional terminal environments are often assembled from themes, shells, completion frameworks, search tools, and navigation helpers. The result is usually scattered configuration and a high migration cost. This setup separates six components by responsibility and uses a clear installation order to reduce setup errors.
The core idea is not deep customization. It is usability first, enhancement second. That makes this stack especially suitable for developers who want to upgrade their terminal experience quickly, especially those moving from the default Terminal app or iTerm2 to a more modern workflow.
The tool responsibilities are clearly layered
| Tool | Role | Key Value |
|---|---|---|
| Ghostty | Terminal Emulator | GPU rendering, rich themes, lightweight startup |
| Fish | Interactive Shell | Native syntax highlighting, autosuggestions, smart completions |
| Starship | Prompt | Displays Git status, language versions, and exit codes |
| fzf | Fuzzy Finder | Quickly searches command history, files, and directories |
| zoxide | Directory Jumper | Learns and prioritizes your navigation habits |
| Raycast | Launch Entry Point | Centralizes tool launching and search |
The value of this layered design is that each tool solves one problem well, while the combined stack significantly improves overall interaction efficiency.
The correct installation order prevents configuration failures
You only need two prerequisites: macOS and Homebrew. If Homebrew is not installed, install it first and verify the version before moving on.
# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Verify that brew is available
brew --versionThese commands establish a single package management entry point. Every component in the rest of this guide is installed through brew.
You must install a Nerd Font first to display icons correctly
Starship and some terminal themes depend on special glyphs. If the font is missing, Git branch symbols, arrows, and directory icons may render as broken boxes. That is why font installation must come first.
# Install Meslo Nerd Font for Starship and terminal themes
brew install font-meslo-lg-nerd-font
# Verify that the font is registered with the system
system_profiler SPFontsDataType | grep -i "meslo"These commands install and verify the font. If you see MesloLGS NF, the setup is generally successful.
Ghostty provides the modern visual and interaction foundation
Ghostty is the rendering layer of this entire setup. It handles performance, split panes, tabs, and theme presentation. Unlike traditional terminal emulators that mainly optimize for compatibility, Ghostty focuses more on modern UX and low latency.
# Install Ghostty
brew install --cask ghostty
# List built-in themes
ghostty +list-themesThese two commands install the terminal emulator itself and let you preview its built-in theming capabilities.
Ghostty configuration should focus on themes, fonts, and interaction habits
Store your configuration in ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty. The core settings should define the theme, font, and window behavior.
# Basic Ghostty configuration
theme = "tokyonight" # Set the theme
font-family = "MesloLGS NF" # Use a Nerd Font
font-size = 14 # Set the font size
font-thicken = true # Increase glyph thickness for readability
background-opacity = 0.95 # Set background opacity
background-blur = true # Enable background blur
window-padding-x = 10 # Set horizontal padding
window-padding-y = 5 # Set vertical padding
keybind = cmd+alt+right=next_tab # Switch to the next tab
keybind = cmd+alt+left=previous_tab # Switch to the previous tabThis configuration defines the terminal’s visual style and tab-switching behavior. Restart Ghostty after editing the file for the changes to take effect.
Fish upgrades your default shell into a smarter interactive environment
Fish offers a major advantage: many advanced features are built in natively, without relying on plugin ecosystems such as Oh My Zsh. Syntax highlighting, history-based suggestions, and descriptive completions work out of the box.
# Install Fish
brew install fish
# Check the Fish installation path
which fish
# Register Fish as a valid system shell
echo /opt/homebrew/bin/fish | sudo tee -a /etc/shells
# Set Fish as the default shell
chsh -s /opt/homebrew/bin/fishThese commands install Fish and switch your default shell. After the change, reopen the terminal and verify that Fish is active.
Fish configuration becomes the main entry point for the rest of the stack
Starship, fzf, and zoxide are all loaded centrally through ~/.config/fish/config.fish. This keeps the structure consistent and makes migration easier.
if status is-interactive
set -U fish_greeting # Disable the greeting to reduce noise
starship init fish | source # Load the Starship prompt
fzf --fish | source # Load fzf key bindings and integrations
set -gx FZF_CTRL_T_OPTS "--walker-skip .git,node_modules,target" # Skip large directories
zoxide init fish | source # Load zoxide smart navigation
alias ll "ls -lh" # Common long-list alias
alias la "ls -lAh" # Show hidden files
endThis configuration centralizes interactive initialization, fuzzy search, directory jumping, and common aliases in one place.
Starship, fzf, and zoxide work together to improve terminal efficiency
Starship helps you see more clearly, fzf helps you find things quickly, and zoxide helps you jump faster. Together, they turn the terminal from a basic command input tool into an interactive workspace with immediate feedback.
# Install Starship, fzf, and zoxide
brew install starship
brew install fzf
brew install zoxide
# Generate a preset Starship theme configuration
mkdir -p ~/.config
starship preset tokyo-night -o ~/.config/starship.toml
# Initialize fzf extended integrations
/opt/homebrew/opt/fzf/installThese commands install the three core capabilities: prompt rendering, fuzzy search, and intelligent navigation.
The most useful shortcuts directly impact your daily productivity
Ctrl + R performs fuzzy search through command history, which is ideal for recovering long commands you ran before. Ctrl + T searches files in the current directory. Alt + C helps you jump to a directory quickly. z keyword navigates directly to frequently used paths based on your history.
# Common zoxide usage
z project # Jump to the best-matching project directory
z src api # Match a directory using multiple keywords
zi # Select a directory interactively with fzf
z - # Return to the previous directoryThese commands cover two high-frequency scenarios: finding a directory and returning to one.
Raycast is optional, but it is a worthwhile desktop entry point
Raycast does not directly change terminal capabilities, but it can unify actions such as Homebrew management, GitHub access, and clipboard history into one global launcher. For developers who frequently switch across tools, it works like a desktop-level command palette.
Recommended extensions include Brew, GitHub, and Clipboard History. The first improves package management, while the other two strengthen code collaboration and context reuse.
A stable final configuration matters more than flashy customization
The key to this stack is not how many settings you tweak. It is whether you follow a fixed rhythm: install one tool, verify it, add configuration, load it immediately, and then move to the next tool. This makes problems easier to isolate and prevents error amplification across multiple components.
If you want to modernize the experience further, you can add eza as a replacement for ls. It provides clearer file trees and better Git-aware output.
# Install eza and replace basic ls behavior
brew install eza
alias ls="eza" # Replace ls with eza
alias ll="eza -lh --git" # Long list with Git information
alias tree="eza --tree" # Show a directory treeThis configuration improves directory browsing and works well as a later incremental enhancement.
[AI Readability Summary]
This guide rebuilds a modern terminal stack for macOS developers. It covers the installation order, configuration method, and collaboration model of Ghostty, Fish, Starship, fzf, zoxide, and Raycast, helping you create a highly readable, efficient, and extensible terminal workflow with minimal setup friction.
FAQ
1. Why do I need to install a Nerd Font first?
Because Starship and some themes depend on special icon glyphs. If the font is missing, branch icons, arrows, and directory symbols in the prompt will render incorrectly, which directly affects readability.
2. What is Fish’s core advantage over Bash or Zsh?
Fish provides syntax highlighting, autosuggestions, and smart completions as native features. You can get a high-quality interactive experience without building a large plugin stack, which also reduces maintenance cost.
3. What are the most common failure points in this setup?
The three most common issues are missing fonts that cause garbled icons, Fish not being set as the default shell so the configuration never loads, and configuration changes not being reloaded or Ghostty not being restarted. Following the order of install → verify → configure → source will significantly reduce setup problems.