README

Oh My Zsh is an open source, community-driven framework for managing your zsh
configuration.

Sounds boring. Let's try again.

Oh My Zsh will not make you a 10x developer...but you may feel like one.

Once installed, your terminal shell will become the talk of the town _or your money back!_ With each keystroke
in your command prompt, you'll take advantage of the hundreds of powerful plugins and beautiful themes.
Strangers will come up to you in cafés and ask you, _"that is amazing! are you some sort of genius?"_

Finally, you'll begin to get the sort of attention that you have always felt you deserved. ...or maybe you'll
use the time that you're saving to start flossing more often. 😬

To learn more, visit ohmyz.sh, follow @ohmyzsh on X (formerly
Twitter), and join us on Discord.








  
    
    
  




Table of Contents

- Getting Started
  - Operating System Compatibility
  - Prerequisites
  - Basic Installation
    - Manual Inspection
- Using Oh My Zsh
  - Plugins
    - Enabling Plugins
    - Using Plugins
  - Themes
    - Selecting A Theme
  - Shellsavers
  - FAQ
- Advanced Topics
  - Advanced Installation
    - Custom Directory
    - Unattended Install
    - Installing From A Forked Repository
    - Manual Installation
  - Installation Problems
  - Custom Plugins And Themes
  - Enable GNU ls In macOS And FreeBSD Systems
  - Skip Aliases
  - Async git prompt
- Getting Updates
  - Updates Verbosity
  - Manual Updates
- Uninstalling Oh My Zsh
- How Do I Contribute To Oh My Zsh?
  - Do Not Send Us Themes
- Contributors
- Follow Us
- Merchandise
- License
- About Planet Argon



 Getting Started

 Operating System Compatibility

| O/S            | Status |
| :------------- | :----: |
| Android        |   ✅   |
| FreeBSD        |   ✅   |
| LCARS          |   🛸   |
| Linux          |   ✅   |
| macOS          |   ✅   |
| OS/2 Warp      |   ❌   |
| Windows (WSL2) |   ✅   |

 Prerequisites

- Zsh should be installed (v4.3.9 or more recent is fine but we prefer 5.0.8 and
  newer). If not pre-installed (run zsh --version to confirm), check the following wiki instructions here:
  Installing ZSH
- curl or wget should be installed
- git should be installed (recommended v2.4.11 or higher)

 Basic Installation

Oh My Zsh is installed by running one of the following commands in your terminal. You can install this via the
command-line with either curl, wget or another similar tool.

| Method    | Command                                                                                           |
| :-------- | :------------------------------------------------------------------------------------------------ |
| curl  | sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" |
| wget  | sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"   |
| fetch | sh -c "$(fetch -o - https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" |

Alternatively, the installer is 

Top issues

Discussions