starship

Initialize for bash

$ eval "$(starship init bash)"

$ eval "$(starship init zsh)"

$ starship init fish | source

$ starship print-config

$ starship preset [pastel-powerline] > ~/.config/starship.toml

$ starship prompt

$ starship explain

$ starship timings

starship [init shell] [prompt] [preset] [options]

starship is a minimal, fast, cross-shell prompt. Written in Rust, it provides consistent appearance and features across bash, zsh, fish, PowerShell, and more.
Configuration in ~/.config/starship.toml customizes modules. Each module shows specific information: git status, language versions, cloud context, etc.
Modules appear contextually. Python version shows only in Python projects. Git info shows only in repositories. This keeps prompts clean.
Presets provide ready-made configurations. They range from minimal to information-rich, with various color schemes.
Speed is a priority. The prompt renders quickly even with many modules enabled. Timings command helps identify slow modules.
The prompt is cross-platform, working on Linux, macOS, and Windows. Configuration is portable across systems.

init SHELL

Generate shell init script.

Print prompt.

Print preset configuration.

Print config.

Explain prompt segments.

Time prompt rendering.

Generate completions.

Generate bug report.

Show help.

Show version.

~/.config/starship.toml

Main configuration file defining enabled modules, display format, colors, and per-module settings.

Environment variable to specify an alternate configuration file path.

Requires Nerd Font for icons. Configuration syntax may differ from shell prompts. Some modules need external commands.

Starship was created by Matan Kushner around 2019. It gained popularity as a fast, configurable alternative to framework-specific prompts like Oh My Zsh themes.

bash(1), zsh(1), fish(1), powerline(1)