starship 0.31.0

The cross-shell prompt for astronauts. ☄🌌️
Documentation

🍬 Features

  • Prompt character turns red if the last command exits with non-zero code
  • Current Go 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 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

🚀 Installation

Prerequisites

Getting Started

  1. Install the starship binary:

    Install Latest Version

    With Shell:
    curl -fsSL https://starship.rs/install.sh | bash

    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.