Pretty, minimal and fast ZSH prompt
Most prompts are cluttered, ugly and slow. I wanted something visually pleasing that stayed out of my way.
gitbranch and whether it's dirty (with a
gitcommits with up/down arrows. (Check is done asynchronously!)
Can be installed with
npm or manually. Requires Git 2.0.0+ and ZSH 5.2+. Older versions of ZSH are known to work, but they are not recommended.
$ npm install --global pure-prompt
That's it. Skip to Getting started.
pure.zsh to somewhere in
$fpath with the name
$fpath with the name
$ ln -s "$PWD/pure.zsh" /usr/local/share/zsh/site-functions/prompt_pure_setup$ ln -s "$PWD/async.zsh" /usr/local/share/zsh/site-functions/async
echo $fpath to see possible locations.
For a user-specific installation (which would not require escalated privileges), simply add a directory to
$fpath for that user:
# .zshenv or .zshrcfpath=
Then install the theme there:
$ ln -s "$PWD/pure.zsh" "$HOME/.zfunctions/prompt_pure_setup"$ ln -s "$PWD/async.zsh" "$HOME/.zfunctions/async"
Initialize the prompt system (if not so already) and choose
# .zshrcautoload -U promptinit; promptinitprompt pure
The max execution time of a process before its run time is shown when it exits. Defaults to
PURE_GIT_PULL=0 to prevent Pure from checking whether the current Git remote has been updated.
PURE_GIT_UNTRACKED_DIRTY=0 to not include untracked files in dirtiness check. Only really useful on extremely huge repos like the WebKit repo.
Time in seconds to delay git dirty checking for large repositories (git status takes > 5 seconds). The check is performed asynchronously, this is to save CPU. Defaults to
Defines the prompt symbol. The default value is
Defines the git down arrow symbol. The default value is
Defines the git up arrow symbol. The default value is
# .zshrcautoload -U promptinit; promptinit# optionally define some optionsPURE_CMD_MAX_EXEC_TIME=10prompt pure
To have commands colorized as seen in the screenshot, install zsh-syntax-highlighting.
.zshrcto disable oh-my-zsh themes.
oh-my-zsh overrides the prompt so Pure must be activated after
Pure is bundled with Prezto. No need to install it.
prompt pure to your
Pure is bundled with Zim. No need to install it.
.zshrc file with the following two lines (order matters). Do not use the
antigen theme function.
antigen bundle mafredri/zsh-asyncantigen bundle sindresorhus/pure
.zshrc file with the following two lines (order matters):
antibody bundle mafredri/zsh-asyncantibody bundle sindresorhus/pure
.zshrc file with the following two lines:
zplug mafredri/zsh-async, from:githubzplug sindresorhus/pure, use:pure.zsh, from:github, as:theme
zpty: can't open pseudo terminal: bad file descriptor.
This is a known issue.
zsh/zpty requires either legacy bsd ptys or access to
/dev/ptmx. Here are some known solutions.
$ sudo sh -c "echo 'SANDBOX_WRITE=\"/dev/ptmx\"' > /etc/sandbox.d/10zsh"$ sudo emerge -1 zsh
On a default setup, running the command
kldload pty should do the trick. If you have a custom kernel, you might need to add
device pty to the configuration file (example).
|Sindre Sorhus||Mathias Fredriksson|
MIT © Sindre Sorhus