sorin-ionescu / prezto

# Prezto — Instantly Awesome Zsh
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
interface environment with sane defaults, aliases, functions, auto completion,
and prompt themes.
## Installation
### Manual
Prezto will work with any recent release of Zsh, but the minimum required
version is **4.3.11**.
01. Launch Zsh:
 [code] 
02. Clone the repository:
 [code] 
 Optional: Installing in $XDG_CONFIG_HOME 
 Optionally, if you already have `$XDG_CONFIG_HOME` configured (usually as
 _`$HOME/.config`_ by default) and intend to install Prezto under
 _`$XDG_CONFIG_HOME/zsh`_ instead, you can clone the repository there and
 configure `$ZDOTDIR` separately if not already configured.
 - Clone the repository:
 [code] 
 - Configure `$XDG_CONFIG_HOME` and `$ZDOTDIR` in _`$HOME/.zshenv`_:
 [code] 
03. Create a new Zsh configuration by copying/linking the Zsh configuration
 files provided:
 [code] 
 **Note:** If you already have any of the given configuration files, `ln` in
 the above operation will cause an error. In simple cases, you can load
 Prezto by adding the line `source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh"` to
 the bottom of your _`${ZDOTDIR:-$HOME}/.zshrc`_ and keep the rest of your
 Zsh configuration intact. For more complicated setups, we recommend that you
 back up your original configs and replace them with the provided Prezto
 [_`runcoms`_][10].
04. Set Zsh as your default shell:
 [code] 
05. Open a new Zsh terminal window or tab.
### Troubleshooting
If you are not able to find certain commands after switching to Prezto, modify
the `PATH` variable in _`${ZDOTDIR:-$HOME}/.zprofile`_ then open a new Zsh
terminal window or tab.
## Updating
Run `zprezto-update` to automatically check if there is an update to Prezto.
If there are no file conflicts, Prezto and its submodules will be automatically
updated. If there are conflicts you will be instructed to go into the
`$ZPREZTODIR` directory and resolve them yourself.
To pull the latest changes and update submodules manually:
 [code] 
## Usage
Prezto has many features disabled by default. Read the source code and the
accompanying README files to learn about what is available.
### Modules
01. Browse [_`modules`_][9] to see what is available.
02. Load the modules you need in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then open
 a new Zsh terminal window or tab.
### Themes
01. For a list of themes, type `prompt -l`.
02. To preview a theme, type `prompt -p name`.
03. Load the theme you like in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then
 open a new Zsh terminal window or tab.
 ![sorin theme][2]
 Note that the [_`git`_][11] module may be required for special symbols to
 appear, such as those on the right of the above image. Add `'git'` to the
 `pmodule` list (under `zstyle ':prezto:load' pmodule \` in your
 _`${ZDOTDIR:-$HOME}/.zpreztorc`_) to enable this module.
### External Modules
01. By default modules will be loaded from [_`/modules`_][9] and _`/contrib`_.
02. Additional module dir