oh-my-zsh should work with any recent release of zsh, the minimum recommended version is 4.3.9.
The automatic installer
curl -L https://github.com/pludoni/oh-my-zsh/raw/master/tools/install.sh | sh
wget --no-check-certificate https://github.com/pludoni/oh-my-zsh/raw/master/tools/install.sh -O - | sh
The manual way
1. Clone the repository
git clone git://github.com/pludoni/oh-my-zsh.git ~/.oh-my-zsh
2. Create a new zsh config by copying the zsh template we’ve provided.NOTE: If you already have a ~/.zshrc file, you should back it up.
cp ~/.zshrc ~/.zshrc.origin case you want to go back to your original settings.
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
3. Set zsh as your default shell:
chsh -s /bin/zsh
4. Start / restart zsh (open a new terminal is easy enough…)
You might need to modify your PATH in ~/.zshrc if you’re not able to find some commands after switching to Oh My Zsh.
- enable the plugins you want in your
~/.zshrc(take a look at
plugins/to see what’s possible)
plugins=(git osx ruby)
- Theme support: Change the
ZSH_THEMEenvironment variable in
- Take a look at the current themes that come bundled with Oh My Zsh.
- much much more… take a look at
lib/what Oh My Zsh offers…
the refcard is pretty tasty for tips.
If you want to override any of the default behavior, just add a new file (ending in
.zsh) into the
If you have many functions which go well together you can put them as a *.plugin.zsh file in the
custom/plugins/ directory and then enable this plugin.
If you would like to override the functionality of a plugin distributed with oh-my-zsh, create a plugin of the same name in the
custom/plugins/ directory and it will be loaded instead of the one in
If you want to uninstall it, just run
uninstall_oh_my_zsh from the command line and it’ll remove itself and revert you to bash (or your previous zsh config).