🙃 A delightful community-driven (with 2,400+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140+ themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.
Find a file
2010-03-30 12:44:29 -05:00
custom Moving some example files into custom/ 2009-09-23 08:02:58 -07:00
functions adding homebrew completions - and a function dir 2009-10-26 00:47:23 -04:00
lib will do auto-rehash 2010-03-30 12:44:29 -05:00
log Adding a file into log/ so that we have a log file to record history to 2009-08-31 11:17:05 -07:00
templates Enabled colors in ls and made it possible to theme them 2009-11-05 20:44:28 +01:00
themes added my theme, based on xiong-chiamiov-plus but using vcs_info 2010-03-30 16:21:42 +00:00
tools Updating check_for_upgrade script to fix issue when the LAST_EPOCH file/value got corrupted. Closes #32 2009-12-12 13:45:30 -08:00
.gitignore merge upstream 2009-09-23 16:14:04 +01:00
oh-my-zsh.sh Based on a suggestion from robbyrussel, using env for greater compatibility. 2009-12-13 12:38:37 -07:00
README.textile last time -- with feeling 2010-03-30 16:26:01 +00:00

A handful of functions, auto-complete helpers, and stuff that makes you shout...

bq. "OH MY ZSHELL!"

This is forked from http://github.com/robbyrussell/oh-my-zsh

h2. Setup

h3. The manual install


1. Clone the repository

  @git clone http://github.com/squarepegsys/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.orig@ in 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..)

h3. Problems?

You _might_ need to modify your PATH in ~/.zshrc if you're not able to find some commands after switching to oh-my-zsh.

h2. Usage

TODO: Update this..

* auto rehash
* Put in Terminal configurator for those strange terminal settings
* easier support for more SCM's (now it's mostly Git)
* Have different zsh on the same machine share history
* Put in some Django shortcuts
* More to come

h2. Useful

the "refcard":http://www.bash2zsh.com/zsh_refcard/refcard.pdf is pretty tasty for tips.

h3. Customization

If you want to override any of the default behavior, just add a new file (ending in @.zsh@) into the @custom/@ directory.

h3. Uninstalling

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).

h2. Thanks

* Robby Russell  for starting this project in the first place

h2. Help out!

I just quote robbyrussel:

bq. I'm far from being a zsh-expert and suspect there are many ways to improve. If you have ideas on how to make the configuration easier to maintain (and faster), don't hesitate to fork and send pull requests!

I would love more advance yet nice ZSH stuff\