Starship Cross-Shell Prompt Setup: A Beautiful Prompt for Every Shell

Why Starship for Your Prompt?

Install and configure Starship, the minimal, fast, and customizable prompt that works with bash, zsh, fish, and PowerShell. Show git status, language versions, and more.

Starship generates your shell prompt from a single TOML file. It detects git branches, language versions, and Kubernetes context — showing only what matters in the current directory.

By the end of this 8 min guide, you'll have a working Starship setup and practical Starship workflows you can use immediately.

• Understand what Starship does and why it matters for Terminal
• Install and configure Starship for your environment
• Build Starship-specific workflows with real examples
• Troubleshoot common Starship issues with concrete fixes

Installing Starship

Install Starship:

brew install starship

• Terminal environment with appropriate permissions
• No prior Starship experience needed
• A terminal with true color support
• Git for version-controlling your config

Configuring starship.toml

Add the init script to your shell config, then customize starship.toml. Each module (git, python, node, etc.) can be enabled, disabled, or reformatted independently.

Here's a foundational configuration to start with:

# starship.toml
[character]
success_symbol = "[➜](bold green)
error_symbol = "[✗](bold red)
[git_branch]
symbol = " "
[python]
symbol = " "
format = "[$symbol($version)]($style) "

• Begin with this config and make small, incremental changes
• Document each setting with inline comments
• Test changes one at a time to isolate issues
• Keep your config in a Git repo for easy rollback and sharing

Module Customization

With Starship configured, these Starship-specific workflows will save you time every day:

• Git branch and status in your prompt
• Language version detection (Python, Node, Rust)
• Kubernetes context and namespace
• AWS/GCP profile for cloud work
• Command duration timer for slow commands

Multi-Shell Integration

Once you're comfortable with Starship basics, these advanced techniques will transform your Starship workflow:

• Custom modules with shell commands
• Conditional formatting based on directory
• Presets for minimal or maximal prompts
• Per-directory config overrides

Prompt Performance & Lag

Here are the most common Starship issues and how to fix them:

• Prompt not showing? Add eval "$(starship init zsh)" to .zshrc
• Slow prompt? Disable unused modules in config
• Icons showing as boxes? Install a Nerd Font
• Config not loading? Check TOML syntax with starship config

A Prompt for Every Shell

Congratulations — you now have a solid Starship foundation. Here's where to go next:

• Explore the official Starship documentation for features not covered here
• Join the Starship community (GitHub Discussions, Discord, or Reddit)
• Check the related tutorials below for deeper Starship dives
• Build your own Starship configuration and share it with the community