#prompt #shell #bash #fish #zsh

bin+lib starship

The minimal, blazing-fast, and infinitely customizable prompt for any shell! ☄🌌️

68 releases (35 breaking)

✓ Uses Rust 2018 edition

new 0.36.0 Feb 13, 2020
0.34.1 Feb 3, 2020
0.32.2 Dec 28, 2019
0.26.5 Nov 27, 2019
0.4.0 Jul 29, 2019

#8 in Command line utilities

Download history 609/week @ 2019-11-01 611/week @ 2019-11-08 843/week @ 2019-11-15 1080/week @ 2019-11-22 1124/week @ 2019-11-29 1548/week @ 2019-12-06 874/week @ 2019-12-13 567/week @ 2019-12-20 963/week @ 2019-12-27 848/week @ 2020-01-03 1063/week @ 2020-01-10 1319/week @ 2020-01-17 1098/week @ 2020-01-24 1033/week @ 2020-01-31 961/week @ 2020-02-07

4,373 downloads per month
Used in nu

ISC and maybe MPL-2.0

270KB
6.5K SLoC

Starship – Cross-shell prompt

GitHub Actions workflow status Crates.io version Packaging status
Chat on Discord Contributors

Website · Installation · Configuration

English   日本語   繁體中文   Русский   Deutsch   简体中文   Español   Français

Starship with iTerm2 and the Snazzy theme

The minimal, blazing-fast, and infinitely customizable prompt for any shell!

  • Fast: it's fast – really really fast! 🚀
  • Customizable: configure every aspect of your prompt.
  • Universal: works on any shell, on any operating system.
  • Intelligent: shows relevant information at a glance.
  • Feature rich: support for all your favorite tools.
  • Easy: quick to install – start using it in minutes.

Explore the Starship docs  â–¶

🚀 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):

    Invoke-Expression (&starship init powershell)
    

    Ion

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

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

🤝 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.

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. 👋

💭 Inspired By

Please check out these previous works that helped inspire the creation of starship. 🙏


Starship rocket icon

📝 License

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

Dependencies

~22MB
~497K SLoC