# Oh My Zsh — Delightful Framework for Managing Zsh Configuration

> Oh My Zsh is a delightful, community-driven framework for managing your Zsh configuration. 300+ plugins (git, docker, node, python, homebrew), 140+ themes, and auto-update tooling. The de facto starting point for developer terminals.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
# Install (official one-liner)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Or via wget
sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

Edit `~/.zshrc`:
```bash
ZSH_THEME="agnoster"
plugins=(git docker node npm pnpm pyenv zsh-autosuggestions zsh-syntax-highlighting)
```

```bash
source ~/.zshrc
omz update        # Update OMZ
omz reload        # Reload config
```

## Intro

Oh My Zsh is a delightful, open-source, community-driven framework for managing your Zsh configuration. Created by Robby Russell in 2009 with the tagline "A delightful community-driven framework", OMZ ships with 300+ plugins, 140+ themes, and sane defaults. 186K GitHub stars make it the most-starred shell project on GitHub.

- **Repo**: https://github.com/ohmyzsh/ohmyzsh
- **Stars**: 186K+
- **License**: MIT

## What Oh My Zsh Does

- **300+ plugins** — git aliases, docker completion, node version manager helpers, kubectl, python, rails, macos, tmux
- **140+ themes** — agnoster, powerlevel10k, robbyrussell, spaceship, honukai
- **Auto-update** — `omz update` pulls latest from GitHub
- **Aliases** — shortcuts for common commands
- **Completions** — enhanced tab-complete for tools
- **Framework helpers** — `omz plugin`, `omz theme`, `omz pr test`
- **Community** — 2400+ contributors

## Architecture

OMZ lives in `~/.oh-my-zsh/`. Your `~/.zshrc` sources `$ZSH/oh-my-zsh.sh` which loads themes + plugins in order. Plugins are just directories with a `.plugin.zsh` file. Themes are `.zsh-theme` files that set `PROMPT` and `RPROMPT`.

## Self-Hosting

Shell framework — installs to your home directory.

## Key Features

- 300+ built-in plugins
- 140+ built-in themes
- Auto-update system
- Plugin system
- Command aliases
- Enhanced completions
- Git status in prompt
- Active community

## Comparison

| Framework | Plugins | Themes | Speed |
|---|---|---|---|
| Oh My Zsh | 300+ | 140+ | Slow to start |
| Prezto | ~30 | ~20 | Faster |
| Zinit | Any (via manager) | Any | Fastest |
| Antigen | Any | Any | Fast |
| zap | Any | Any | Very fast |

## FAQ

**Q: Slow startup?**
A: OMZ loads a lot by default. Fixes: disable unused plugins, enable `zcompdump` caching, or switch to an on-demand loader like zinit/zap.

**Q: What about Powerlevel10k?**
A: p10k is one of the most popular themes — install it separately, then set `ZSH_THEME="powerlevel10k/powerlevel10k"` in `.zshrc`. A configuration wizard runs on first launch.

**Q: Does it work on Windows?**
A: Yes. Use WSL2 or Git Bash + Zsh on Windows. Native PowerShell isn't supported.

## Sources & Credits

- Docs: https://ohmyz.sh
- GitHub: https://github.com/ohmyzsh/ohmyzsh
- License: MIT

---
Source: https://tokrepo.com/en/workflows/oh-my-zsh-delightful-framework-managing-zsh-configuration-85b6b249
Author: Script Depot