# denysdovhan/spaceship-prompt

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/denysdovhan-spaceship-prompt).**

20,515 stars · 967 forks · Shell · MIT

## Links

- GitHub: https://github.com/denysdovhan/spaceship-prompt
- Homepage: https://spaceship-prompt.sh
- awesome-repositories: https://awesome-repositories.com/repository/denysdovhan-spaceship-prompt.md

## Description

Spaceship Prompt is a customizable Zsh prompt theme that serves as a development environment monitor, shell environment indicator, and system status monitor. It renders a visual interface for the terminal to display active programming language runtimes, package manager versions, and hardware battery levels.

The project functions as a Git status indicator and infrastructure context display, tracking the state of version control repositories and showing active container versions and cluster contexts for cloud and local environments.

The tool provides capabilities for shell context visualization, including the current directory, username, and hostname. Users can customize the prompt appearance and the specific information fields displayed to suit their workflow needs.

## Tags

### Operating Systems & Systems Programming

- [Shell Prompt Themes](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-customization-tools/terminal-customization/shell-prompt-themes.md) — Provides a comprehensive, customizable visual configuration for Zsh prompts including system status and directory context.
- [Prompt Customization Tools](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-customization-tools/terminal-customization/prompt-customization-tools.md) — Provides utilities for configuring the visual segments and information fields displayed in the shell prompt. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))
- [Prompt Segments](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-management/prompt-configuration-utilities/prompt-segments.md) — Constructs the prompt by concatenating independent data modules that provide system and environment status.
- [Shell Hook Integrations](https://awesome-repositories.com/f/operating-systems-systems-programming/shell-hook-integrations.md) — Leverages Zsh-native hooks to trigger prompt updates whenever the working directory or environment changes.

### User Interface & Experience

- [Terminal Prompt Themes](https://awesome-repositories.com/f/user-interface-experience/terminal-prompt-themes.md) — Renders a minimalistic visual interface for the command line to show relevant system and project information. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))
- [User-Defined Layouts](https://awesome-repositories.com/f/user-interface-experience/layout-positioning/user-defined-layouts.md) — Allows users to customize and save the spatial arrangement and visibility of prompt elements.

### Development Tools & Productivity

- [Development Environment Management](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management.md) — Tracks active programming language runtimes and package managers directly within the shell prompt.
- [Development Environment Monitors](https://awesome-repositories.com/f/development-tools-productivity/development-environment-monitors.md) — Acts as a terminal display that identifies active programming language runtimes and package managers.
- [Runtime Version Detectors](https://awesome-repositories.com/f/development-tools-productivity/runtime-version-detectors.md) — Identifies active versions of programming languages and package managers running in the environment. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))
- [Runtime Version Indicators](https://awesome-repositories.com/f/development-tools-productivity/runtime-version-indicators.md) — Identifies and displays active programming language runtimes and package manager versions in the terminal.
- [Shell Context Visualizers](https://awesome-repositories.com/f/development-tools-productivity/shell-context-visualizers.md) — Displays the current directory, hostname, username, and background jobs for immediate situational awareness. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))
- [Shell Situational Awareness Tools](https://awesome-repositories.com/f/development-tools-productivity/shell-situational-awareness-tools.md) — Displays the current directory, username, and system status to maintain situational awareness in the terminal.
- [Shell Integration](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/automation-integration-tools/shell-integration.md) — Hooks into the shell environment to provide dynamic prompt updates based on real-time directory and git status.
- [Version Control and Repository Tools](https://awesome-repositories.com/f/development-tools-productivity/version-control-repository-tools.md) — Tracks the current state and status of source control repositories directly in the command line. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))
- [Runtime Detection Utilities](https://awesome-repositories.com/f/development-tools-productivity/runtime-detection-utilities.md) — Detects active programming language runtimes and package manager versions to display in the terminal prompt.

### DevOps & Infrastructure

- [Git Status Indicators](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control-integrations/git-status-indicators.md) — Provides visual cues for Git repository status and current branch directly within the shell.
- [Visual Context Indicators](https://awesome-repositories.com/f/devops-infrastructure/cluster-management/client-cluster-contexts/visual-context-indicators.md) — Displays active container versions and cluster contexts to track the current deployment environment.
- [Container Context Monitors](https://awesome-repositories.com/f/devops-infrastructure/container-context-monitors.md) — Monitors active Docker or Kubernetes contexts and versions to identify the current deployment environment.
- [Infrastructure State Management](https://awesome-repositories.com/f/devops-infrastructure/infrastructure-state-management.md) — Displays the active container version and cluster context to track the status of the current environment. ([source](https://github.com/denysdovhan/spaceship-prompt#readme))

### Software Engineering & Architecture

- [Prompt Context Injections](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variable-injection/runtime-variable-injections/runtime-context-injections/prompt-context-injections.md) — Injects real-time system data such as battery levels and container contexts into the prompt output.

### Part of an Awesome List

- [Terminal Prompts](https://awesome-repositories.com/f/awesome-lists/devtools/terminal-prompts.md) — Feature-rich Zsh prompt designed for power users.