ohmyzsh/plugins/responsive-prompt

Responsive Prompt

Responsive Prompt is a OhMyZSH plugin, which makes your prompt responsive to your terminal's column size. It does so, by watching $COLUMNS environment variables. When it changes, this plugin reloads your ZSH prompt.

Different Prompts

You can define several prompts for your terminal via functions named like _prompt_60, which defines the prompt to be used when $COLUMNS is greater than 60. Note that, you must set $PROMPT_BREAKPOINTS variable, appropriately, for this to work. Example:

PROMPT_BREAKPOINTS=(100 50 0)
_prompt_100(){ PROMPT="<prompt1>"; }  # prompt when $COLUMNS > 100
_prompt_50() { PROMPT="<prompt2>"; }  # prompt when 100 >= $COLUMNS > 50
_prompt_0()  { PROMPT="<prompt3>"; }  # prompt when  50 >= $COLUMNS > 0

You can, even, define different prompts using conditional statements in your $PROMPT_FILE. In this case, your $PROMPT_FILE will be sourced, whenever the value of $COLUMNS change, to reload your prompt. Example:

if [[ $COLUMNS -gt 100 ]]; then
  PROMPT="<prompt1>"
elif [[ $COLUMNS -gt 50 ]]; then
  PROMPT="<prompt2>"
else
  PROMPT="<prompt3>"
fi

Variables

• PROMPT_FILE: File which will be sourced (in order to reload the PROMPT), if no appropriate prompt-setting functions were found. Since, most ZSH users will have prompt defined somewhere inside their ~/.zshrc file, it is the default. However, if you have a dedicated file for your prompt, you can specify it with this option, which will speed up prompt rendering.

• PROMPT_BREAKPOINTS: If you use prompt-setting functions, you can use this variable to define the various $COLUMNS values, when the plugin should reload your prompt. Note that, you must define this variable in a decreasing array format. Default value: (120 90 60 0), which means that when $COLUMNS is greater than 120, _prompt_120 function will be called, and so on. If the plugin is unable to find a function by these names, your $PROMPT_FILE will be sourced to reload the prompt.

• PROMPT_NEWLINE_AFTER: If you prefer to break your prompt into a multi-line prompt when it exceeds a given display length, you can use this variable to specify such length. Once the prompt exceeds this length, a newline character will be inserted in the variable $prompt_newline, which you can use inside your prompt definition. Otherwise, this variable will remain empty.