58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# Pure
|
|
|
|
> Pretty, minimal and fast ZSH prompt
|
|
|
|
|
|
|
|
|
|
## 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](https://gist.github.com/3898739) 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](screenshot-title-cmd.png) when a process is running.
|
|
- Can easily be used as a starting point for your own custom prompt.
|
|
|
|
|
|
## Getting started
|
|
|
|
- Submodule this repo or download `pure.zsh`.
|
|
*Submodule is recommended as it makes it easy to keep it up to date.*
|
|
- In your `.zshrc` add any of the below options, then import pure `. path/to/pure.zsh`.
|
|
|
|
|
|
## 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
|
|
|
|
```sh
|
|
# .zshrc
|
|
|
|
# optionally define some options
|
|
PURE_CMD_MAX_EXEC_TIME=10
|
|
|
|
# import the prompt
|
|
. pure.zsh
|
|
```
|
|
|
|
|
|
## Tip
|
|
|
|
[Tomorrow Night Eighties](https://github.com/chriskempson/tomorrow-theme) theme with the [Droid Sans Mono](http://www.google.com/webfonts/specimen/Droid+Sans+Mono) font (15pt) is a beautiful combination, as seen in the screenshot above.
|
|
|
|
|
|
## License
|
|
|
|
MIT © [Sindre Sorhus](http://sindresorhus.com)
|