Warp Documentation
Search…
Prompt

What is it

Warp has a native Prompt that shows your current working directory (cwd) and also git branch information when in a git directory. You can also enable a custom prompt by configuring the PS1 or by installing a supported shell prompt plugin, see Compatibility Table. PS1 is a variable used by the shell to generate the prompt, it represents the primary prompt string (hence the β€œPS”) - which is what you see most of the time before typing a new command in your terminal.

How to access it

  • Enable custom prompt by right-clicking on the prompt area above the input and select "Use my own prompt" or go to Settings > Features and toggle on "Honor user's custom prompt (PS1)".

How it works

Custom Prompt Demo

Known Incompatibilities

If you’re having issues with prompts, please see below or our Known Issues for more troubleshooting steps.

Custom Prompt Compatibility Table

Shell
Tool
Does it work?
Bash/zsh
​PS1​
Working
Bash
SBP
Coming soon
Bash/zsh
​Starship​
Working
zsh
​oh-my-zsh​
Working
zsh
​prezto​
Working
zsh
Powerlvel10k
Not supported
zsh
zplug
Not supported
Bash/zsh
Powerline-shell
Coming soon
SSH
​
Working

Multi-Line and Right-Sided Prompts

We don’t currently support multi-line or right-sided prompts. The Input Editor is a separate UI element from the Prompt; this is actually what enables a modern text editor experience. Improving the native Prompt is on the roadmap.

iTerm2

The iTerm2 shell integration breaks Warp and your custom prompt will not be able to be visible with this on. If you're coming from iTerm please check your dotfiles for it. We advise disabling the integration just for Warp like so:
if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then
##### WHAT YOU WANT TO DISABLE FOR WARP - BELOW
​
test -e "${HOME}/.iterm2_shell_integration.zsh" && source "${HOME}/.iterm2_shell_integration.zsh"
​
##### WHAT YOU WANT TO DISABLE FOR WARP - ABOVE
fi

Powerlevel10K (P10K)

We don't currently support P10K. Because of how we use the prompt_command in Warp and because P10K can be installed standalone or as an Oh-My-Zsh plugin, each of which results in different problems and requires special handling.
We advise using Warp's default prompt or installing one of the supported tools, see PS1 Compatibility Table. You can disable P10K just for Warp as such:
if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then
##### WHAT YOU WANT TO DISABLE FOR WARP - BELOW
​
# POWERLEVEL10K
​
##### WHAT YOU WANT TO DISABLE FOR WARP - ABOVE
fi

Context Chips

Context Chips is an idea we have for how the future of terminal prompts could be like, i.e. prompts that support dynamic refreshing, mouse interactions, and can be customized via an open spec that developers can build on. Learn more via our Twitter thread, where we also shared some Figma mocks.
Copy link
On this page
What is it
How to access it
How it works
Known Incompatibilities
Custom Prompt Compatibility Table
Context Chips