Zsh Terminal Setup with Starship

A quick guide to install and configure the blazing-fast Starship prompt for zsh.

Reference: Starship official site

Prerequisites

• Install a Nerd Font and set it as your terminal’s font (e.g., FiraCode Nerd Font).

Install Starship

Choose one of the methods below.

macOS (Homebrew)

brew install starship

Linux (curl script)

curl -sS https://starship.rs/install.sh | sh

If you prefer a package manager, check your distro’s package repo or the Starship docs.

Windows (WSL)

Run the Linux install inside your WSL distro, then continue with the zsh config below.

Enable Starship in zsh

Add this to the end of your ~/.zshrc:

eval "$(starship init zsh)"

Then reload your shell:

exec zsh
# or
source ~/.zshrc

Verify

starship --version

You should see the Starship version and a refreshed prompt.

Optional: Basic configuration

Create ~/.config/starship.toml for customization. Example:

# ~/.config/starship.toml
format = "$all"
add_newline = true

[character]
success_symbol = "➜ "
error_symbol = "✗ "

For more modules and options, see the docs: starship.rs.