The Fish Shell Framework
Go to file
Justin Hileman 027be0a1ee [bobthefish] allow git untracked files override
Showing untracked files can be (very) slow on large NFS mounts. Allow the user to disable the '...' output when there are untracked files, either globally via fish config:

    set -g theme_display_git_untracked no

 or locally via git repo config:

    git config bash.showUntrackedFiles false

Fixes #434
2015-04-24 10:59:50 -07:00
custom fixing example custom load file format 2013-02-07 09:31:59 -02:00
functions do not traverse completions directory 2015-02-19 02:22:57 -02:00
plugins Add emacs plugin (even more updated) 2015-04-01 10:23:00 +05:30
script test runner should search fish_path for specs instead of * 2015-01-21 13:03:35 +09:00
spec import tests 2015-02-19 01:46:30 -02:00
templates try plugin: quick theme switcher 2015-02-19 19:56:12 -02:00
themes [bobthefish] allow git untracked files override 2015-04-24 10:59:50 -07: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 Ignore ta plugin's data dir 2015-03-18 08:49:06 +09: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 Subsequent tests should run if one test fails. 2015-01-13 19:16:48 -02:00
README.md Simplifying about section 2015-04-03 14:00:06 -03:00

About
|
Installation
|
Usage
|
Contribute
|
Uninstall
|
License

Build Status ![](https://img.shields.io/badge/Framework-Oh My Fish-blue.svg?style=flat) Join the chat at https://gitter.im/bpinto/oh-my-fish

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

If you want to install it manually, keep reading.

Usage

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.

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 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 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.

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.

Manual installation

  1. Clone the repository

    git clone git://github.com/bpinto/oh-my-fish.git ~/.oh-my-fish
    
  2. Create a new fish config by copying the fish template we've provided.

    cp ~/.oh-my-fish/templates/config.fish ~/.config/fish/config.fish
    
  3. Start / restart fish (just open a new terminal)

Uninstall

rm -rf ~/.oh-my-fish

License

MIT © Contributors

Logo by marcker🔹 Attribution CC 4.0