# spaceship-prompt/spaceship-prompt

🚀✨ Minimalistic, powerful and extremely customizable Zsh prompt

Repository: https://github.com/spaceship-prompt/spaceship-prompt
Canonical: https://ross.abutalabs.com/products/spaceship-prompt
Homepage: https://spaceship-prompt.sh
Language: Shell
License: MIT
License Family: permissive
Topics: zsh, zsh-users, prompt, oh-my-zsh, zsh-theme, shell, spaceship, shell-prompt, terminal, shell-theme
Last push: 2026-08-05T22:32:54+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 91, longevity 100
- inputs: {"age_days": 3868, "days_push": 28, "days_rel": 63, "gap_med": 21, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 20566, forks 973 (observed 2026-08-28T04:11:30.203471+00:00)

## What it is
Spaceship is a minimalistic, powerful, and extremely customizable prompt theme for the Zsh shell. It displays useful context like git status, language runtime versions, Docker/Kubernetes info, and battery level, and works out of the box with zero configuration.

## Use cases
- customize my zsh terminal prompt
- show git branch and status in my shell prompt
- display node/python/rust version in terminal prompt
- make my terminal prompt look modern with nerd fonts
- zsh prompt theme that works with oh-my-zsh
- show kubernetes context and docker version in prompt

## When to choose
- you use Zsh and want a feature-rich prompt that works with minimal setup
- you want to see git status, language runtimes, and cloud context at a glance
- you need deep customization of prompt sections via an easy configuration interface
- you use a plugin manager like oh-my-zsh, antigen, or zinit

## When to avoid
- you use bash, fish, or another non-Zsh shell
- you want an extremely minimal prompt with no extra sections
- your terminal cannot use Powerline/Nerd fonts or UTF-8 symbols

## Facets
- artifact type: plugin
- maturity: active
- function: cli, developer-tools, terminal-ui, configuration-management
- domain: developer-tools, cross-platform
- platform: cli, cross-platform
- tags: zsh, shell-prompt, oh-my-zsh, terminal-theme, git-integration, developer-experience, command-line, linux, macos

## Member repositories
- spaceship-prompt/spaceship-prompt (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:30.203471+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:58:46.634856+00:00, confidence not recorded.
  - readme: https://github.com/spaceship-prompt/spaceship-prompt (fetched 2026-08-28T04:11:30.203471+00:00, sha 8f33788ce7b8)
  - homepage: https://spaceship-prompt.sh (fetched 2026-08-29T07:57:24.086203+00:00, sha cca57b27880f)
  - site_page: https://spaceship-prompt.sh/getting-started (fetched 2026-08-29T07:57:24.095392+00:00, sha fa0cfe0ac8e3)
  - site_page: https://spaceship-prompt.sh/faq (fetched 2026-08-29T07:57:24.097706+00:00, sha 6f780833bdff)
- Data as of 2026-08-30T08:39:29.467469+00:00.