Starship Prompt Builder

Character module

Render the final input character for success, error, and Vim editing modes.

When it appears

It is the cursor-side end of the prompt and always chooses one configured symbol.

Preview

Rendered from the starting configuration in a representative simulated environment.

starship — preview
❮ 

Starting configuration

[character]
success_symbol = "[❯](bold green)"
error_symbol = "[❯](bold red)"
vimcmd_symbol = "[❮](bold green)"
Open in the builder

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

Key options

formatstring
The format string used before the text input.
success_symbolstring
The format string used before the text input if the previous command succeeded.
error_symbolstring
The format string used before the text input if the previous command failed.
vimcmd_symbolstring
The format string used before the text input if the shell is in vim normal mode.
vimcmd_visual_symbolstring
The format string used before the text input if the shell is in vim visual mode.

Format variables

$symbol
A mirror of either success_symbol, error_symbol, vimcmd_symbol or vimcmd_replace_one_symbol etc.

Common adjustments

  • Keep success and error shapes consistent if colour alone should carry status.
  • Give Vim command modes a reversed shape so mode remains clear without text.
  • Leave character at the end of the prompt so input begins in the expected place.