How to configure 3rd party prompts


nerdfonts are not required but they make the presentation much better.

siteopen in new window

repoopen in new window


siteopen in new window

repoopen in new window

If you like oh-my-poshopen in new window, you can use oh-my-posh with Nushell with a few steps. It works great with Nushell. How to setup oh-my-posh with Nushell:

  1. Install Oh My Posh and download oh-my-posh's themes following guideopen in new window.
  2. Download and install a nerd fontopen in new window.
  3. Generate the file. By default it will be generated to your home directory. You can use --config to specify a theme, other wise, oh-my-posh comes with a default theme.
  4. Initialize oh-my-posh prompt by adding in ~/.config/nushell/ the path output by $nu.config-path) to source ~/
# Generate the file
> oh-my-posh init nu --config ~/.poshthemes/M365Princess.omp.json

# Initialize at shell startup by adding this line in your file
> source ~/

For MacOS users:

  1. You can install oh-my-posh by brew, just following the guide hereopen in new window
  2. Download and install a nerd fontopen in new window.
  3. Set the PROMPT_COMMAND in the file output by $nu.config-path, here is a code snippet:
let posh_dir = (brew --prefix oh-my-posh | str trim)
let posh_theme = $'($posh_dir)/share/oh-my-posh/themes/'
# Change the theme names to: zash/space/robbyrussel/powerline/powerlevel10k_lean/
# material/half-life/lambda Or double lines theme: amro/pure/spaceship, etc.
# For more [Themes demo](
$env.PROMPT_COMMAND = { || oh-my-posh prompt print primary --config $'($posh_theme)/zash.omp.json' }
# Optional
$env.PROMPT_INDICATOR = $"(ansi y)$> (ansi reset)"


siteopen in new window

repoopen in new window

  1. Follow the links above and install Starship.
  2. Install nerdfonts depending on your preferences.
  3. Use the config example below. Make sure to set the STARSHIP_SHELL environment variable.


An alternate way to enable Starship is described in the Starship Quick Installopen in new window instructions.

The link above is the official integration of Starship and Nushell and is the simplest way to get Starship running without doing anything manual:

  • Starship will create its own configuration / environment setup script
  • you simply have to create it in and use it in

Here's an example config section for Starship:

$env.STARSHIP_SHELL = "nu"

def create_left_prompt [] {
    starship prompt --cmd-duration $env.CMD_DURATION_MS $'--status=($env.LAST_EXIT_CODE)'

# Use nushell functions to define your right and left prompt
$env.PROMPT_COMMAND = { || create_left_prompt }

# The prompt indicators are environmental variables that represent
# the state of the prompt

Now restart Nu.

nushell on 📙 main is 📦 v0.60.0 via 🦀 v1.59.0


repoopen in new window

Contributors: Antoine Stevan, JT, Justin Ma, Darren Schroeder, David Knaack, Harry Sarson, HoLLy, Hofer-Julian, Mark Volkmann, Michel Philippe Barutel, Reilly Wood, Sean Buckley, Tyler Ruckinger, sebastian-xyz