starship: A Rust repository from haraldh

Website · Installation · Configuration

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

A Nerd Font installed and enabled in your terminal (for example, try the Fira Code Nerd Font).

Getting Started

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
```
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 Microsoft.PowerShell_profile.ps1. You can check the location of this file by querying the $PROFILE variable in PowerShell. Typically the path is ~\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. 👋

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

💭 Inspired By

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

denysdovhan/spaceship-prompt - A ZSH prompt for astronauts.
denysdovhan/robbyrussell-node - Cross-shell robbyrussell theme written in JavaScript.
reujab/silver - A cross-shell customizable powerline-like prompt with icons.

haraldh/starship

🚀 Installation

Prerequisites

Getting Started

Install Latest Version

From prebuilt binary, with Shell:

From source on crates.io:

Install via Package Manager

With Homebrew:

With Scoop:

Bash

Fish

Zsh

PowerShell