Awesome
Pure-now
Pretty, minimal and fast ZSH prompt with Zeit's
now
flavour
Overview
This is a maintened fork of the awesome prompt Pure.
It asynchronously adds current now
team/user to the prompt.
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 (with a*
). - Indicates when you have unpushed/unpulled
git
commits with up/down arrows. (Check is done asynchronously!) - 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 only displayed when in an SSH session.
- Shows the current path in the title and the current folder & command when a process is running.
- Support VI-mode indication by reverse prompt symbol (Zsh 5.3+).
- Makes an excellent starting point for your own custom prompt.
Install
Can be installed with npm
. Requires Git 2.0.0+ and ZSH 5.2+. Older versions of ZSH are known to work, but they are not recommended.
npm
$ npm install --global pure-prompt-now
// or
$ yarn global add pure-prompt-now
That's it.
Getting started
Initialize the prompt system (if not so already) and choose pure-now
:
# .zshrc
autoload -U promptinit; promptinit
prompt pure-now
Options
Option | Description | Default value |
---|---|---|
PURE_CMD_MAX_EXEC_TIME | The max execution time of a process before its run time is shown when it exits. | 5 seconds |
PURE_GIT_PULL=0 | Prevents Pure from checking whether the current Git remote has been updated. | |
PURE_GIT_UNTRACKED_DIRTY=0 | Do not include untracked files in dirtiness check. Mostly useful on large repos (like WebKit). | |
PURE_GIT_DELAY_DIRTY_CHECK | Time in seconds to delay git dirty checking when git status takes > 5 seconds. | 1800 seconds |
PURE_PROMPT_SYMBOL | Defines the prompt symbol. | ❯ |
PURE_PROMPT_VICMD_SYMBOL | Defines the prompt symbol used when the vicmd keymap is active (VI-mode). | ❮ |
PURE_GIT_DOWN_ARROW | Defines the git down arrow symbol. | ⇣ |
PURE_GIT_UP_ARROW | Defines the git up arrow symbol. | ⇡ |
Example
# .zshrc
autoload -U promptinit; promptinit
# optionally define some options
PURE_CMD_MAX_EXEC_TIME=10
prompt pure-now
Tips
In the screenshot you see Pure running in Hyper with the hyper-snazzy theme and Menlo font.
The Tomorrow Night Eighties theme with the Droid Sans Mono font (15pt) is also a nice combination.<br> Just make sure you have anti-aliasing enabled in your terminal.
To have commands colorized as seen in the screenshot, install zsh-syntax-highlighting.
Integration
oh-my-zsh
- Set
ZSH_THEME=""
in your.zshrc
to disable oh-my-zsh themes. - Follow the Pure-now Install instructions.
- Do not enable the following (incompatible) plugins:
vi-mode
,virtualenv
.
NOTE: oh-my-zsh
overrides the prompt so Pure must be activated after source $ZSH/oh-my-zsh.sh
.
prezto
Pure is bundled with Prezto. No need to install it.
Add prompt pure-now
to your ~/.zpreztorc
.
zim
Pure is bundled with Zim. No need to install it.
Set zprompt_theme='pure-now'
in ~/.zimrc
.
antigen
Update your .zshrc
file with the following two lines (order matters). Do not use the antigen theme
function.
antigen bundle mafredri/zsh-async
antigen bundle chabou/pure-now
antibody
Update your .zshrc
file with the following two lines (order matters):
antibody bundle mafredri/zsh-async
antibody bundle chabou/pure-now
zplug
Update your .zshrc
file with the following two lines:
zplug mafredri/zsh-async, from:github
zplug chabou/pure-now, use:pure.zsh, from:github, as:theme
zplugin
Update your .zshrc
file with the following two lines (order matters):
zplugin ice pick"async.zsh" src"pure.zsh"
zplugin light chabou/pure-now
FAQ
There are currently no FAQs.
See FAQ Archive for previous FAQs.
Ports
- ZSH - therealklanni/purity - More compact current working directory, important details on the main prompt line, and extra Git indicators. - intelfx/pure - Solarized-friendly colors, highly verbose, and fully async Git integration. - dfurnes/purer - Compact single-line prompt with built-in Vim-mode indicator.
- Bash - sapegin/dotfiles - Prompt and color theme for Terminal.app.
- Fish - brandonweiss/pure.fish - Pure-inspired prompt for Fish. Not intended to have feature parity. - rafaelrinaldi/pure - Support for bare Fish and various framework (Oh-My-Fish, Fisherman, and Wahoo).
- Rust - xcambar/purs - Pure-inspired prompt in Rust.
Team
Sindre Sorhus | Mathias Fredriksson |
License
MIT © Sindre Sorhus