starship 0.35.1

The cross-shell prompt for astronauts. โ˜„๐ŸŒŒ๏ธ
Documentation

๐Ÿฌ Features

  • Prompt character turns red if the last command exits with non-zero code
  • Current Elm version (๐ŸŒณ)
  • Current Go version (๐Ÿน)
  • Current Haskell version (ฮป)
  • Current Java version(โ˜•)
  • Current Node.js version(โฌข)
  • Current PHP version (๐Ÿ˜)
  • Current Python version (๐Ÿ)
  • Current Ruby version (๐Ÿ’Ž)
  • Current Rust version (๐Ÿฆ€)
  • Current .NET version (โ€ขNET)
  • Current Crystal version (๐Ÿ”ฎ).
  • Current version of package in current directory (๐Ÿ“ฆ)
    • npm (Node.js)
    • cargo (Rust)
    • poetry (Python)
    • composer (PHP)
  • Current Git branch and rich repo status:
    • = โ€” conflicting changes
    • โ‡ก โ€” ahead of remote branch
    • โ‡ฃ โ€” behind of remote branch
    • โ‡• โ€” diverged changes
    • ? โ€” untracked changes
    • $ โ€” stashed changes
    • ! โ€” modified files
    • + โ€” added files
    • ยป โ€” renamed files
    • โœ˜ โ€” deleted files
  • Current Mercurial branch
  • Current battery level and status
    • โ‡ก โ€“ charging
    • โ‡ฃ โ€“ discharging
    • โ€ข โ€“ fully charged
  • Indicator for jobs in the background (โœฆ)
  • Current Kubernetes Cluster and Namespace (โ˜ธ)
  • Current Amazon Web Services (AWS) profile (โ˜๏ธ)
  • Execution time of the last command
  • Custom environment variable value
  • Nix-shell environment detection
  • Current username if not the same as the logged-in user
  • Optional current time in 12/24hr format
  • Current Terraform Workspace and version (๐Ÿ’ )
  • Current Conda environment (C)

๐Ÿš€ Installation

Prerequisites

Getting Started

  1. Install the starship binary:

    Install Latest Version

    From prebuilt binary, with Shell:
    curl -fsSL https://starship.rs/install.sh | bash
    
    From source on crates.io:
    cargo install starship
    

    Install via Package Manager

    With Homebrew:
    brew install starship
    
    With Scoop:
    scoop install starship
    
  2. Add the init script to your shell's config file:

    Bash

    Add the following to the end of ~/.bashrc:

    # ~/.bashrc
    
    eval "$(starship init bash)"
    

    Fish

    Add the following to the end of ~/.config/fish/config.fish:

    # ~/.config/fish/config.fish
    
    starship init fish | source
    

    Zsh

    Add the following to the end of ~/.zshrc:

    # ~/.zshrc
    
    eval "$(starship init zsh)"
    

    PowerShell

    Add the following to the end of ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 (or ~/.config/powershell/Microsoft.PowerShell_profile.ps1 on -Nix):

    # ~\Documents\PowerShell\Profile.ps1
    
    Invoke-Expression (&starship init powershell)
    

    Ion

    Add the following to the end of ~/.config/ion/initrc:

    # ~/.config/ion/initrc
    
    eval $(starship init ion)
    

๐Ÿ”ง Configuration

For details on how to configure Starship, check out our documentation.

๐Ÿค Contributing

We are always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a good first issue.

High Priority Needs

  • ๐Ÿ‘ฉโ€๐Ÿ’ผ Product Manager
    • We have a GitHub Project and many unorganized/unprioritized features, as well as ideas that haven't yet been made into issues. Starship needs someone to own the product direction!
  • ๐Ÿ‘ฉโ€๐ŸŽจ Designer
    • Like making eye-catching websites? Excellent! We are looking to create a beautiful landing page showing off Starship in all its glory. Helping design for Starship's brand is a great opportunity to try out new ideas!
  • ๐Ÿ‘ฉโ€๐Ÿ’ป Rust Developer
    • There is a lot of low-hanging fruit when it comes to writing idiomatic Rust, designing effective Rust architecture, performance optimizations, cross-platform build optimizations, and more! I (@matchai) am a beginner to Rust. Come point us in the right direction!

If you are interested in helping contribute to starship, please take a look at our Contributing Guide. Also, feel free to drop into our Discord server and say hi. ๐Ÿ‘‹

Contributors

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

๐Ÿ’ญ Inspired By

Please check out these previous works that helped inspire the creation of starship. ๐Ÿ™

๐Ÿ“ License

Copyright ยฉ 2019-present, Starship Contributors. This project is ISC licensed.