Spaceship Prompt
Customizable Zsh prompt that shows Git/Mercurial status, language runtime versions, Docker, Kubernetes, battery and more, with support for custom sections.
Spaceship is a prompt theme for Zsh (v5.2 or newer). It replaces the default prompt with one that displays contextual information next to the command line. It is built from "sections", each of which shows one piece of information and can be configured individually.
Documented sections include hostname and username, repository status (Git and Mercurial), runtime environment versions for languages such as Node.js, Rust, Python, Ruby, Swift, Go and PHP, Docker version, Kubernetes context, connected machine, package version (npm, lerna, cargo, composer and others), battery level and status, and an indicator for background jobs. Users can also write their own sections to show custom information, and the docs describe per-directory configuration.
It needs a Powerline or Nerd Font in the terminal. Installation is supported through Homebrew, npm, the AUR, and Zsh frameworks and plugin managers such as Oh-My-Zsh, prezto, zim, antigen, antibody, zinit, zgen, zplug and sheldon, or by cloning the repo and sourcing spaceship.zsh manually. It is aimed at Zsh users who want a configurable prompt that shows project and environment context, and it can be used alongside plugins such as zsh-autosuggestions and zsh-syntax-highlighting.
Installation
# via Homebrew
brew install spaceship
# via npm
npm install -g spaceship-prompt
# via AUR (yay)
yay -S spaceship-prompt

Alternatives & related tools
tpm
Tmux Plugin Manager: installs, updates, and removes tmux plugins from GitHub or other git repositories, configured via ~/.tmux.conf.
Pure
ZSH prompt that shows git branch, dirty state, and async-checked unpushed/unpulled arrows, with exit-status coloring and command execution time.
zsh-autosuggestions
Zsh plugin that shows inline command suggestions after the cursor, drawn from history and tab-completion, in the style of Fish.
Powerlevel10k
Zsh prompt theme with an interactive configuration wizard, instant prompt at shell startup, Git status segments, and Powerlevel9k config compatibility.
Oh My Zsh
Community-maintained framework for managing zsh configuration, with 300+ plugins, 140+ themes, and a built-in updater.
add a badge to your README
Maintain Spaceship Prompt? Show that it's featured on trmn. The badge links back to this page.
[](https://www.trmn.sh/tools/spaceship-prompt?utm_source=badge)<a href="https://www.trmn.sh/tools/spaceship-prompt?utm_source=badge"><img src="https://www.trmn.sh/badge/spaceship-prompt.svg" alt="Featured on trmn" height="20"></a>