github-mirror/oh-my-fish
2
0
Fork 0
mirror of https://github.com/oh-my-fish/oh-my-fish.git synced 2024-11-24 15:31:28 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
The Fish Shell Framework
233 Commits 4 Branches 6 Tags 3.7 MiB
Shell 99.6%
C 0.3%
Dockerfile 0.1%
ef24766b0e
Go to file
Bruno Pinto ef24766b0e Closes #81: default to python2 and fallback to python
2014-01-06 18:57:32 -02:00
custom fixing example custom load file format 2013-02-07 09:31:59 -02:00
functions adding function to source bash scripts 2013-11-20 08:09:42 -02:00
plugins Closes #81: default to python2 and fallback to python 2014-01-06 18:57:32 -02:00
templates Revert "fish has renamed . to source" 2013-10-18 14:15:47 -03:00
themes Add mtahmed theme. 2013-11-20 17:50:46 -05:00
tools Use public HTTPS when installing Oh My Fish 2013-11-20 06:10:09 -02:00
.gitignore add my custom theme 2013-01-13 16:49:28 +00:00
oh-my-fish.fish extracting _append_path function 2013-11-20 07:35:31 -02:00
README.markdown removing copy prompts function from readme 2013-11-20 07:05:35 -02:00

README.markdown

Oh My Fish!

Why?

Developing on a shell should be a pleasure. Our goal is to help developers that don't 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, 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.sh | sh

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 plugins add this line set fish_plugins git rails
to your configuration file.

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

I'm hoping to collect a bunch of themes for our command prompts. You can see existing ones in the themes directory.

Switching to fish

If you wish to use fish as your default shell, use the following command:

grep -q '^/usr/local/bin/fish$' /etc/shells; or echo '/usr/local/bin/fish' | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish

chsh will prompt you for your password, and change your default shell.

To switch your default shell back, you can run:

chsh -s /bin/bash

Substitute /bin/bash with /bin/tcsh or /bin/zsh as appropriate.

Manual installation

  1. Clone the repository
    git clone git://github.com/bpinto/oh-my-fish.git ~/.oh-my-fish
  1. Create a new fish config by copying the fish template we've provided.
    cp ~/.oh-my-fish/templates/config.fish ~/.config/fish/config.fish
  1. Start / restart fish (just open a new terminal)

Uninstall

rm -rf ~/.oh-my-fish

###. Oh My ZSH

This project is heavily inspired by oh-my-zsh