README

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 FiraCode Nerd Font).

 Step 1. Install Starship

Select your operating system from the list below to view installation instructions:


Android

Install Starship using any of the following package managers:

| Repository | Instructions           |
| ---------- | ---------------------- |
| [Termux]   | pkg install starship |




BSD

Install Starship using any of the following package managers:

| Distribution | Repository      | Instructions                      |
| ------------ | --------------- | --------------------------------- |
| _Any_    | [crates.io] | cargo install starship --locked |
| FreeBSD      | [FreshPorts]    | pkg install starship            |
| NetBSD       | [pkgsrc]        | pkgin install starship          |




Linux

Install the latest version for your system:

sh
curl -sS https://starship.rs/install.sh | sh


Alternatively, install Starship using any of the following package managers:

| Distribution       | Repository              | Instructions                                                  |
| ------------------ | ----------------------- | ------------------------------------------------------------- |
| _Any_          | [crates.io]         | cargo install starship --locked                             |
| _Any_              | [conda-forge]           | conda install -c conda-forge starship                       |
| _Any_              | [Linuxbrew]             | brew install starship                                       |
| Alpine Linux 3.13+ | [Alpine Linux Packages] | apk add starship                                            |
| Arch Linux         | [Arch Linux Extra]      | pacman -S starship                                          |
| CentOS 7+          | [Copr]                  | dnf copr enable atim/starship  dnf install starship |
| Debian 13+         | [Debian Main]           | apt install starship                                        |
| Fedora 40+         | [Copr]                  | dnf copr enable atim/starship  dnf install starship |
| Gentoo             | [Gentoo Packages]       | emerge app-shells/starship                                  |
| Manjaro            |                         | pacman -S starship                                          |
| NixOS    

Top issues

Discussions

Latest release

1.27.0 (2026-10-17)

 Security
This release contains fixes for GHSA-x486-6jjc-phfp and GHSA-679r-jwc5-r5m3.

 Features

 Add jj_bookmark module (7643) (6f33dce)
 add jj_change module (7691) (70c705e)
 add jj_metrics module (7720) (471858d)
 add jj_status module (7729) (3ead2a0)
 Add Jujutsu support to the vcs module (7612) (131bf95)
 bash: Support right prompt in Bash via Flyline (7673) (85b8a61)
 claude_model: add effort variable (7614) (ea4098c)
 git_branch: add ignore_remotes option (7671) (0f9da35)
 jj: Better bookmark discovery and improving JJ output parsing (7761) (013bef