linux/ohmyzsh: 🙃 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.

mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2025-12-26 02:12:33 +01:00

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

cli cli-app hacktoberfest oh-my-zsh oh-my-zsh-plugin oh-my-zsh-theme ohmyzsh plugin-framework plugins productivity shell terminal theme themes zsh zsh-configuration

Find a file

$U-UPCORP\igen322$ U-UPCORP\igen322 9525512518 now ESC-. gives you the last argument of the previous command		2010-04-26 14:15:13 -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	now ESC-. gives you the last argument of the previous command	2010-04-26 14:15:13 -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	option to configure strange terminals	2010-03-30 13:14:38 -05:00
themes	added my theme, based on xiong-chiamiov-plus but using vcs_info	2010-03-30 16:21:42 +00:00
.gitignore	merge upstream	2009-09-23 16:14:04 +01:00
oh-my-zsh.sh	took out upgrade checker	2010-03-30 12:47:31 -05:00
README.textile	forgot to document strange terminals	2010-03-30 13:23:04 -05:00

README.textile

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. Features different than robbyrussel's version

* Option to configure a terminal with strange settings (labor intensive on the first run, perfectly wonderful after that.)
* Will automatically rehash the path, so new commands will be found immediately
* Added realias to quickly make a new shell alias/function (EDITOR env variable required)
* Removed upgrade checker
* share history with your zsh's on the same host

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

* 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\