Oh My Zsh: a tangled personal zsh config becomes a 900-contributor framework

In the summer of 2009 Robby Russell, a web developer who had used zsh daily for more than three years, was helping a coworker debug something in the terminal. The default Bash prompt did not respond to the shortcuts his brain was used to, and he kept urging colleagues at the Portland agency Planet Argon to switch to zsh. His own .zshrc, assembled from configurations friends shared on IRC, had become a tangled rat's nest — he admitted he did not know what about 30 percent of it did — and coworkers who knew that refused to copy it.

Instead of asking people to paste his file, Russell reorganized the config into a collection of smaller readable files, wrote setup instructions, and on August 28, 2009 packaged everything into a new git repository. His goal was modest: get one or two team members using his scripts. Within a day every developer at Planet Argon had migrated from Bash to zsh.

The project then took shape from feature requests. The day after launch, two coworkers wanted to customize their prompts, so Russell introduced themes; external pull requests followed, and within a month there were a dozen themes. An installer cut setup to one command, an upgrade script followed, and about three weeks later an auto-updater began periodically prompting users to fetch changes — a feature Russell calls the project's turning point, because it kept nearly every user current and subtly introduced them to new features. Ten months in, a plugin system arrived with five plugins.

By March 2016 Oh My Zsh had grown far beyond the agency: about 140 themes, 214 plugins, 910 people whose code had been accepted, and the top spot among GitHub's trending shell repositories. Russell's eight lessons for open source — start small, do not try to account for every scenario, keep documentation human — frame the whole story as playtime that kept building momentum nearly seven years later.