fisher
Manage and install fish shell packages
TLDR
Install one or more plugins
Install a plugin from a GitHub gist
Edit fishfile manually with your favorite editor and install multiple plugins
List installed plugins
Update plugins
Remove one or more plugins
SYNOPSIS
fisher [command] [options] [repo|query]
PARAMETERS
help
Display help and exit
install
Install plugin(s) from repo(s), URLs, or directories
list
List installed plugins
remove
Remove plugin(s) (alias: uninstall)
search
Search plugins on GitHub
self-update
Update Fisher itself
update
Update plugin(s); use '*' for all
-h, --help
Show help
-V, --version
Print version
--no-header
Suppress headers in output
DESCRIPTION
Fisher is a fast, minimalist package manager for the Fish shell. It enables users to discover, install, update, and remove plugins from Git repositories, primarily GitHub.
Fisher clones plugin repositories into ~/.config/fish/fisher and activates them via Fish's native autoloading. Plugins can add completions, themes, key bindings, and utilities without frameworks or bundles.
Unlike Oh My Fish (OMF), Fisher is framework-agnostic, requiring no global configuration. Commands like fisher install fetch and configure plugins instantly. It supports wildcards for bulk operations, e.g., fisher update '*'.
Ideal for extending Fish functionality efficiently, Fisher is the de facto standard, used by thousands for shells like nerd-fisher or z.
CAVEATS
Requires Fish shell (v3.0+ recommended). Plugins must follow Fisher spec (init.fish). No support for non-Git repos natively.
Conflicts possible with OMF; migrate first.
INSTALLATION
curl -sL https://git.io/fisher | source && fisher install jorgebucaran/fisher
POPULAR PLUGINS
jorgebucaran/nvm.fish (Node),
jethrokuan/z (dir jumper),
jorgebucaran/fisherman (self)
HISTORY
Created by Jorge Bucaran in 2015 as a lightweight OMF successor. Reached v4 in 2022 with async installs, config API. Maintained actively on GitHub with 7k+ stars.


