Skip to main content

Secondary prompt

info

This feature only works in powershell, zsh and bash for the time being.

The secondary prompt is displayed when a command text spans multiple lines. The default is > .

You can use go text/template templates extended with sprig to enrich the text. Environment variables are available, just like the console_title_template functionality.

Configuration

You need to extend or create a custom theme with your secondary prompt override. For example:

{
"secondary_prompt": {
"background": "transparent",
"foreground": "#ffffff",
"template": "-> "
}
}

Options

NameTypeDescription
backgroundstringcolor
foregroundstringcolor
templatestringa go text/template template extended with sprig utilizing the properties below - defaults to >
multiline_keeppromptbooleanwhen true, a multi-line command is kept in a single buffer so the primary prompt stays in place until the whole command is submitted (Zsh only). Continuation lines are part of that buffer and get no secondary prompt, so template is not rendered for them. Defaults to false

Template (info)

NameTypeDescription
.Rootbooleanis the current user root/admin or not
.Shellstringthe current shell name
.UserNamestringthe current user name
.HostNamestringthe host name