Starship – Cross-shell prompt

GitHub Actions workflow status Crates.io version Packaging status
Chat on Discord Follow @StarshipPrompt on Twitter

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!

Explore the Starship docs  ▶

🚀 Installation

Prerequisites

Getting Started

  1. Install the starship binary:

    Install Latest Version

    From prebuilt binary, with Shell:

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

    From source on crates.io:

    sh cargo install starship

    Install via Package Manager

    With Homebrew:

    sh brew install starship

    With Scoop:

    powershell scoop install starship

  2. Add the init script to your shell's config file:

    Bash

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

    ```sh

    ~/.bashrc

    eval "$(starship init bash)" ```

    Fish

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

    ```sh

    ~/.config/fish/config.fish

    starship init fish | source ```

    Zsh

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

    ```sh

    ~/.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):

    sh Invoke-Expression (&starship init powershell)

    Ion

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

    ```sh

    ~/.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.