starship/docs

layout	hero	features	footer	metaTitle	description
home	image text tagline actions /logo.svg null The minimal, blazing-fast, and infinitely customizable prompt for any shell! theme text link brand Get Started → ./guide/	title details Compatibility First Works on the most common shells on the most common operating systems. Use it everywhere! title details Rust-Powered Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. title details Customizable Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be.	ISC Licensed | Copyright © 2019-present Starship Contributors	Starship: Cross-Shell Prompt	Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.

Prerequisites

• A Nerd Font installed and enabled in your terminal.

Quick Install

1. Install the starship binary:

   Install Latest Version

   With Shell:

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

   To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration.

   Install via Package Manager

   With Homebrew:

   brew install starship
   

   With Winget:

   winget 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 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)
   

   Elvish

   ::: warning

   Only elvish v0.18 or higher is supported.

   :::

   Add the following to the end of ~/.elvish/rc.elv:

   # ~/.elvish/rc.elv
   
   eval (starship init elvish)
   

   Tcsh

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

   # ~/.tcshrc
   
   eval `starship init tcsh`
   

   Nushell

   Since Nu does not support eval the initialization script is saved in env.nu:

   '
   let starship_path = $nu.default-config-dir | path join scripts starship.nu
   if $nu.is-interactive {
     starship init nu | save $starship_path --force
   }' | save $nu.env-path --append
   '
   if $nu.is-interactive {
     use starship.nu
   }' | save $nu.config-path --append
   

   If you prefer to keep your dotfiles clean you can save it to a different directory then update $env.NU_LIB_DIRS:

   '
   $env.NU_LIB_DIRS ++= ($starship_path | path dirname | to nuon)
   ' | save $nu.env-path --append
   

   Xonsh

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

   # ~/.xonshrc
   
   execx($(starship init xonsh))
   

   Cmd

   You need to use Clink (v1.2.30+) with Cmd. Add the following to a file starship.lua and place this file in Clink scripts directory:

   -- starship.lua
   
   load(io.popen('starship init cmd'):read("*a"))()