Oh My Fish!
Developing on a shell should be a pleasure. Our goal is to help developers that do not want to spend time configuring their own computer to spend time doing what they want.
With the power of our community, we take the already awesome fish shell to another level by creating simple-to-use plugins and themes.
Oh-my-fish is a user-friendly framework for managing your fish-shell configuration. It includes optional plugins (brew, git-flow, rails, python, node, etc) and themes.
Oh-my-fish is built for recent versions of the fish shell, namely "fish 2.0".
curl -L https://github.com/bpinto/oh-my-fish/raw/master/tools/install.fish | fish
If you want to install it manually, keep reading.
Enabling a new plugin or theme is as easy as it should be. Open your fish configuration file
~/.config/fish/config.fish and specify the theme and the plugins you want to use.
As an example, to enable rails and git-flow plugins add this line
set fish_plugins git-flow rails to your configuration file.
Before setting down on a theme, you might want to have a go with all themes using our quick theme switcher by typing
theme --help on your shell.
If you have many functions which go well together, you can create custom plugin in the
directory and add to it as many functions as you want.
If you would like to override the functionality of a plugin distributed with oh-my-fish,
create a plugin of the same name in the
custom/plugins/ directory and it will be loaded
instead of the one shipped with oh-my-fish.
If you would like to use your custom theme, move it with the same name in the
and it will override the original theme in
If you just want to override any of the default behavior or add some environment variables,
just add a new file (ending in .load) into the
Send us your theme!
We are hoping to collect a bunch of themes for our command prompts. You can see existing ones in the themes directory.
Note: Theme authors, make sure to include a screenshot in your pull request.
Clone the repository
git clone git://github.com/bpinto/oh-my-fish.git ~/.oh-my-fish
Create a new fish config by copying the fish template we've provided.
cp ~/.oh-my-fish/templates/config.fish ~/.config/fish/config.fish
Start / restart fish (just open a new terminal)
rm -rf ~/.oh-my-fish