Today I learned how to install the starship cross-shell prompt on Windows for the PowerShell.

A screenshot of my PowerShell starship prompt after I learned how to install the starship cross-shell prompt on my Windows machine.
A screenshot of my PowerShell starship prompt.

What is starship?

Starship is a cross-shell prompt that is highly customisable and looks really cool. The prompt of a shell is that bit that you can typically find on the left of the place where you write commands.

In most shells, the default prompt just shows the path you are in but starship gives you an enhanced prompt that you can customise greatly!

How to install starship on Windows for PowerShell

Here is what I did to get starship on my PowerShell.

First, I went to the starship releases on GitHub and downloaded the correct file. For my Windows computer, that was the file After downloading, I unzipped it and the only thing inside was the starship executable.

The next step is to configure the PowerShell to run the starship executable when it starts.

To prepare for that, I went to %userprofile% and created the folder .starship. Inside, I put the executable starship.exe and created an (empty) TOML file called config.toml for when I decide to configure starship. Now we can tell the PowerShell to run the executable starship.exe because we know exactly where it is. On top of that, we also know where we store our starship configuration.

So, in order to have the PowerShell run starship on startup, we need to modify the PowerShell profile script. To find out where that script lives, just run $PROFILE. Here is what the result is for me:


That's the path where the script lives. That script may or may not exist. If it doesn't, create it. When you open the script, scroll to the bottom, and add the command that runs starship:

# Tell starship where its config is:
$ENV:STARSHIP_CONFIG = "$HOME\.starship\config.toml"
# Start starship:
Invoke-Expression (&$HOME\.starship\starship init powershell)

That's it. That's about all it takes to get starship installed.

Next thing you probably want to do is install a Nerd Font so that the icons that starship uses render properly. Personally, I enjoy the Fira Code family of fonts!

That's it for now! Stay tuned and I'll see you around!

Become a better Python 🐍 developer πŸš€

+35 chapters. +400 pages. Hundreds of examples. Over 30,000 readers!

My book β€œPydon'ts” teaches you how to write elegant, expressive, and Pythonic code, to help you become a better developer. >>> Download it here πŸπŸš€.

Previous Post Next Post

Blog Comments powered by Disqus.