Starship Prompt Builder

Shell level module

Shows how many shells deep you are nested

When it appears

This module is disabled by default. Enable it, then it renders when Starship detects the matching context.

Preview

Rendered from the starting configuration in a representative simulated environment.

starship — preview
↕️  3 

Starting configuration

[shlvl]
disabled = false
format = "[$symbol$shlvl]($style) "
symbol = "↕️  "
style = "bold yellow"
Open in the builder

The configuration is compressed into the URL fragment and stays in your browser.

Key options

thresholdnumber
Display threshold.
formatstring
The format for the module.
symbolstring
The symbol used to represent the SHLVL.
repeatboolean
Causes symbol to be repeated by the current SHLVL amount.
repeat_offsetnumber
Decrements number of times symbol is repeated by the offset value
stylestring
The style for the module.
disabledboolean
Disables the shlvl module.

Format variables

$shlvl
The current value of SHLVL
$style
Mirrors the value of option style
$symbol
Mirrors the value of option symbol

Common adjustments

  • Edit format to reorder its variables or make surrounding text conditional.
  • Adjust its style options to fit the palette used by the rest of the prompt.