Archives
/
fisher
mirror of https://github.com/jorgebucaran/fisher
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
475 Commits
3 Branches
112 Tags
2.8 MiB
Shell 100%
 
event-args
main
comments
4.4.4
4.4.3
4.4.2
4.4.1
4.4.0
4.3.5
4.3.4
4.3.3
4.3.2
4.3.1
4.3.0
4.2.0
4.1.0
3.3.2
3.3.1
3.3.0
3.2.12
3.2.11
3.2.10
3.2.9
3.2.8
3.2.4
3.2.5
3.2.6
3.2.7
3.1.0
3.1.1
3.2.0
3.2.1
3.2.2
3.2.3
3.0.3
3.0.4
3.0.5
3.0.6
3.0.7
3.0.8
3.0.9
2.7.7
2.7.8
2.7.9
2.8.0
2.9.0
3.0.0
2.7.0
2.7.1
2.7.3
2.7.4
2.7.5
2.7.6
2.6.4
2.6.5
2.6.6
2.6.7
2.6.8
2.6.9
2.6.17
2.6.18
2.6.19
2.6.2
2.6.20
2.6.3
2.6.11
2.6.12
2.6.13
2.6.14
2.6.15
2.6.16
2.4.1
2.4.2
2.5.0
2.6.0
2.6.1
2.6.10
2.12.0
2.13.0
2.2.0
2.3.1
2.3.3
2.3.4
2.1.4
2.1.6
2.1.7
2.1.8
2.1.9
2.10.0
2.11.0
2.1.1
2.1.10
2.1.11
2.1.12
2.1.13
2.1.3
1.3.0
1.3.1
1.4.0
1.5.0
2.0.0
2.0.1
0.7.0
0.8.0
0.9.0
1.0.0
1.1.0
1.2.0
0.2.0
0.3.0
0.3.1
0.4.0
0.5.0
0.6.0
4.0.0
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '9ce504e6e0'
${ noResults }
Go to file
Jorge Bucaran 9ce504e6e0
2.8.0 		8 years ago
.travis.yml Remove empty test stub, pave the way for future tests embedded in .travis.yml. 8 years ago
LICENSE Ahoy my mateys! fisherman 2.0.0 (beta) is here. 8 years ago
README.md Better uninstall support, help completions, etc. 8 years ago
fisher.fish 2.8.0 8 years ago

README.md

Build Status Slack

fisherman

A plugin manager for fish.

Translations: 日本語, 简体中文, 한국어, Русский, Português, Español, Català, Deutsch.

Install

Manually

curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisher

With brew

brew tap fisherman/tap
brew install fisherman

Usage

Install a plugin.

fisher mono

Install some plugins.

fisher z fzf edc/bass omf/thefuck

Install a gist.

fisher https://gist.github.com/username/1f40e1c6e0551b2666b2

Install a local directory.

fisher ~/my/plugin

Edit your fishfile and run fisher to commit changes.

$EDITOR ~/.config/fish/fishfile
fisher

Show everything you've installed.

fisher ls
@ plugin     # a local plugin
* mono       # current theme
  bass
  fzf
  thefuck
  z

Show everything that's available.

fisher ls-remote

Update everything.

fisher up

Update some plugins.

fisher up bass z fzf

Remove plugins.

fisher rm thefuck

Remove all the plugins.

fisher ls | fisher rm

Get help.

fisher help z

FAQ

What is the required fish version?

>=2.2.0.

For snippet support, upgrade to >=2.3.0 or append the following code to your ~/.config/fish/config.fish.

for file in ~/.config/fish/conf.d/*.fish
    source $file
end

Is fisherman compatible with oh-my-fish themes and plugins?

Yes.

What is a fishfile and how do I use it?

The fishfile ~/.config/fish/fishfile lists what plugins you've installed.

This file is updated automatically as you install / remove plugins. You can also edit this file and run fisher to commit changes.

This mechanism only installs plugins and missing dependencies. To remove plugins, use fisher rm.

What is a plugin?

A plugin is:

  1. a directory or git repo with one or more .fish functions either at the root level of the project or inside a functions directory

  2. a theme or prompt, i.e, a fish_prompt.fish, fish_right_prompt.fish or both files

  3. a snippet, i.e, one or more .fish files inside a directory named conf.d, evaluated by fish at the start of the session

How can I list plugins as dependencies to my plugin?

Create a new fishfile file at the root level of your project and write the plugin URL such as github.com/owner/repo.