189a1856f8
… since it's likely that some plugin authors will simply copy that one, let's make it a link :)
3.4 KiB
 
Oh My Fish!
Why?
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.
How?
With the power of our community, we take the already awesome fish shell to another level by creating simple-to-use plugins and themes.
What?
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.
## Installation
curl -L https://github.com/bpinto/oh-my-fish/raw/master/tools/install.fish | fish
NOTE: The installation script renames your existing config.fish to config.orig, and replaces it with the default oh-my-fish config. If you have existing customizations to your fish config, you will need to manually include those customizations after the install.
If you want to install it manually, click here.
Usage
Open your fish configuration file ~/.config/fish/config.fish and specify the theme and the plugins you want to use. And then run omf install on your terminal to install them.
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.
Upgrading from previous version
Customization
If you have many functions which go well together, you can create custom plugin in the custom/plugins/PLUGIN_NAME directory and add to it as many functions as you want.
If you would like to use your custom theme, move it with the same name in the custom/themes/ directory and it will override the original theme in themes/.
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 custom/ directory.
Contributing
Create an issue linking to your repository and we will move it to the oh-my-fish organization.
Uninstall
rm -rf ~/.oh-my-fish
