oh-my-posh/website/docs/configuration/secondary-prompt.mdx
2024-11-04 12:15:40 +01:00

54 lines
2.2 KiB
Plaintext

---
id: secondary-prompt
title: Secondary prompt
sidebar_label: Secondary prompt
---
import Config from "@site/src/components/Config.js";
:::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][go-text-template] templates extended with [sprig][sprig] to enrich the text.
Environment variables are available, just like the [`console_title_template`][console-title] functionality.
## Configuration
You need to extend or create a custom theme with your secondary prompt override. For example:
<Config
data={{
secondary_prompt: {
background: "transparent",
foreground: "#ffffff",
template: "-> ",
},
}}
/>
## Properties
| Name | Type | Description |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `background` | `string` | [color][colors] |
| `foreground` | `string` | [color][colors] |
| `template` | `string` | a go [text/template][go-text-template] template extended with [sprig][sprig] utilizing the properties below - defaults to `> ` |
## Template ([info][templates])
| Name | Type | Description |
| ----------- | --------- | ------------------------------------- |
| `.Root` | `boolean` | is the current user root/admin or not |
| `.Shell` | `string` | the current shell name |
| `.UserName` | `string` | the current user name |
| `.HostName` | `string` | the host name |
[go-text-template]: https://golang.org/pkg/text/template/
[sprig]: https://masterminds.github.io/sprig/
[console-title]: /docs/configuration/title#console-title-template
[templates]: /docs/configuration/templates
[colors]: /docs/configuration/colors