Home

Awesome

Alf - Out of this World Zsh

Alf is an out of this world super fast and configurable framework for zsh; it's modeled after Prezto and Antigen. The framework is currently utilizing Oh My Zsh (framework, plugins and themes) and optionally Prezto's plugins under the covers; and offers standard defaults, aliases, functions, auto completion, automated updates and installable prompt themes and plugins.

Why another framework?

At my work I needed to support a similar shell environment across OS X, Windows, and Parallels (running a virtual machine with an OS X host). Originally I was able to get Cygwin running with Oh My Zsh, but I wasn't really happy with the performance. So I started scripting and hacking around and learning Bash and Zsh.

Installation

Alf will work with any recent release of Zsh, but the minimum recommended version is 4.3.11.

OS X

This method will setup everything you need:

\curl -sSL https://raw.githubusercontent.com/psyrendust/alf/master/bootstrap/baseline.zsh | zsh

Or you can pass an optional argument to load a specific branch:

\curl -sSL https://raw.githubusercontent.com/psyrendust/alf/master/bootstrap/baseline.zsh | zsh -s develop

Customization

The project is managed via Git. It is highly recommended that you fork this project; so, that you can commit your changes and push them to GitHub to not lose them. If you do not know how to use Git, follow this tutorial and bookmark this reference.

Resources

The Zsh Reference Card and the zsh-lovers man page are indispensable. awesome-zsh-plugins is a list of zsh plugins and themes that you may also find useful.

Author

Larry Gordon

License

The MIT License (MIT)