# Starship
> The minimal, blazing-fast, and infinitely customizable prompt for any shell

## Summary
A fast, customizable cross-shell prompt. Displays context-aware information like git status, language versions, and cloud context with minimal latency.

## Capabilities
- Displays git branch, status, and ahead/behind info
- Auto-detects and shows language/tool versions (Node, Python, Rust, etc.)
- Highly customizable via ~/.config/starship.toml
- Works across bash, zsh, fish, PowerShell, and more

## When to Use
- Setting up a consistent prompt across multiple shells
- Want context-aware info (git, language versions) in your prompt
- Need a fast prompt that doesn't slow down shell startup

## When NOT to Use
- Prefer a minimal shell with zero prompt customization

## Key Flags
- `init`: Generate shell initialization script (e.g. starship init zsh)
- `preset`: Apply a preconfigured prompt theme (e.g. starship preset nerd-font-symbols)
- `config`: Edit or print the starship configuration file

## Usage Patterns
### Initialize in zsh
```
eval "$(starship init zsh)"
```
Add to .zshrc to activate starship prompt

## Installation
- **homebrew**: `brew install starship`
- **cargo**: `cargo install starship --locked`
- **pacman**: `sudo pacman -S starship`

---
Source: https://littlescripts.sh/tools/starship
