mirror of https://github.com/oh-my-fish/oh-my-fish.git synced 2025-02-02 04:59:30 +08:00

The Fish Shell Framework

fish fishshell fishshell-framework hacktoberfest oh-my-fish oh-my-zsh omf prompt shell terminal

Go to file

Bruno 91f37c43ce Merge pull request #462 from bpinto/external_plugins Vundle style plugins (external plugins)		2015-05-30 13:14:33 +01:00
custom	Add an example completion file.	2015-05-18 22:31:47 -04:00
functions	fish install and updated functions	2015-05-30 13:11:54 +01:00
plugins	FIxing a problem caused by the strange "command command -v rbenv"	2015-05-27 15:25:21 +02:00
script	test runner should search fish_path for specs instead of *	2015-01-21 13:03:35 +09:00
spec	Fix loading of custom plugin completions.	2015-05-18 22:32:42 -04:00
templates	new Plugin and Theme functions	2015-05-30 13:11:54 +01:00
themes	fix(scorphish): redirect Git stderr to /dev/null while	2015-05-23 22:06:36 -03:00
tools	Update install.fish	2015-01-24 18:37:56 -02:00
.editorconfig	Init root .editorconfig file.	2015-02-15 13:30:17 +08:00
.gitignore	no more plugins or themes added to the repo	2015-05-29 21:49:48 +01:00
.travis.yml	travis hook for gitter integration	2015-03-30 21:58:26 -03:00
CONTRIBUTING.md	Update CONTRIBUTING.md	2015-02-01 02:57:55 -02:00
Dockerfile	seq call in getopts should specify negative step	2015-01-24 06:57:51 +09:00
LICENSE	MIT License	2014-07-22 07:25:04 -03:00
oh-my-fish.fish	new Plugin and Theme functions	2015-05-30 13:11:54 +01:00
README.md	Update documentation	2015-05-30 13:11:54 +01:00

README.md

![](https://img.shields.io/badge/Framework-Oh My Fish-blue.svg?style=flat)

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

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

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, keep reading.

Usage

Open your fish configuration file ~/.config/fish/config.fish and specify the theme and the plugins you want to use. And then run fish 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.

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.

Manual installation

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)

Uninstall

rm -rf ~/.oh-my-fish

License

Logo by marcker🔹 Attribution CC 4.0