Pretty, minimal and fast ZSH prompt
Shell
Pull request Compare This branch is 175 commits behind sindresorhus:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
arch
pure.zsh
readme.md
screenshot-title-cmd.png
screenshot.png

readme.md

Pure

Pretty, minimal and fast ZSH prompt

screenshot

Overview

Most prompts are cluttered, ugly and slow. I wanted something visually pleasing that stayed out of my way.

Why?

  • Comes with the perfect prompt character. Author went through the whole Unicode range to find it.
  • Shows git branch and whether it's dirty using the fastest method available.
  • Prompt character turns red if the last command didn't exit with 0.
  • Command execution time will be displayed if it exceeds the set threshold.
  • Username and host is only displayed when in an SSH session.
  • Shows the current path in the title and the current directory and command when a process is running.
  • Can easily be used as a starting point for your own custom prompt.

Getting started

  • Clone this repo, add it as a submodule, or just download pure.zsh.

  • Symlink pure.zsh to somewhere in $fpath with the name prompt_pure_setup.

Example:

$ ln -s "$PWD/pure.zsh" /usr/local/share/zsh/site-functions/prompt_pure_setup

Run echo $fpath to see possible locations.

  • Initialize the prompt system (if not so already):
# .zshrc
autoload -U promptinit && promptinit
  • Choose this prompt:
# .zshrc
prompt pure

Options

PURE_CMD_MAX_EXEC_TIME

The max execution time of a process before its run time is shown when it exits. Defaults to 5 seconds.

Example

# .zshrc

autoload -U promptinit && promptinit

# optionally define some options
PURE_CMD_MAX_EXEC_TIME=10

prompt pure

Tip

Tomorrow Night Eighties theme with the Droid Sans Mono font (15pt) is a beautiful combination, as seen in the screenshot above.

License

MIT © Sindre Sorhus