jorgebucaran /fisher

A plugin manager for Fish

★ 9,462⑂ 280👁 207⑃ 168● 616▤ 65
ShellMITCreated 2015-09-24git.io/fisher
下载:4.4.84.4.8 ↓4.4.82026-01-25
+0
日增长
9,462
stars
280
forks
207
watchers
168
prs
616
issues
65
releases

README

Fisher

 A plugin manager for Fish—your friendly interactive shell. Snag fresh plugins!

Take control of functions, completions, bindings, and snippets from the command line. Unleash your shell's true potential, perfect your prompt, and craft repeatable configurations across different systems effortlessly. Fisher's zero impact on shell startup keeps your shell zippy and responsive. No gimmicks, just smooth sailing!

- Fisher is 100% pure-Fish, making it easy to contribute or modify
- Scorching fast concurrent plugin downloads that'll make you question reality
- Zero configuration needed—we're not kidding!
- Oh My Fish! plugins supported too

  ☝️ Upgrading from Fisher 3.x or older? Strap in and read this!

 Installation

console
curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher


 Quickstart

Fisher lets you install, update, and remove plugins like a boss. Revel in Fish's tab completion and rich syntax highlighting while you're at it.

 Installing plugins

To install plugins, use the install command and point it to the GitHub repository.

console
fisher install jorgebucaran/nvm.fish


 Wanna install from GitLab? No problemo—just prepend gitlab.com/ to the plugin path.

You can also snag a specific version of a plugin by adding an @ symbol after the plugin name, followed by a tag, branch, or commit.

console
fisher install IlanCosman/tide@v6


And hey, you can install plugins from a local directory too!

console
fisher install ~/path/to/plugin


 Heads up! Fisher expands plugins into your Fish configuration directory by default, overwriting existing files. If that's not your jam, set $fisher_path to your preferred location and put it in your function path (640).

 Listing plugins

Use the list command to see all your shiny installed plugins.

console
$ fisher list
jorgebucaran/fisher
ilancosman/tide@v5
jorgebucaran/nvm.fish
/home/jb/path/to/plugin


The list command also plays nice with regular expressions for filtering the output.

console
$ fisher list \^/
/home/jb/path/to/plugin


 Updating plugins

update command to the rescue! It updates one or more plugins to their latest and greatest version.

console
fisher update jorgebucaran/fisher


 Just type fisher update to update everything in one fell swoop.

 Removing plugins

Say goodbye to installed plugins with the remove command.

console
fisher remove jorgebucaran/nvm.fish


Feeling destructive? Wipe out everything, including Fisher itself.

console
fisher list | fisher remove


 Using your fish_plugins file

Whenever you install or remove a plugin from the command line, Fisher jots down all the installed plugins in $__fish_config_dir/fish_plugins. Add this file to your dotfiles or version control to easily share your configuration across different systems.

You can also edit this file and run fisher update to commit changes like a pro:

console
$EDITOR $__fish_config_dir/fish_plugins


diff
jorgebucaran/fi

Top issues

Latest release

4.4.8 4.4.8 2026-01-25
- Add uninstall as an alias to remove by @technicalpickles (807).

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON