LinuxCommandLibrary

fisher

Manage and install fish shell packages

TLDR

Install one or more plugins

$ fisher [plugin1] [plugin2]
copy

Install a plugin from a GitHub gist
$ fisher [gist_url]
copy

Edit fishfile manually with your favorite editor and install multiple plugins
$ [editor] ~/.config/fish/fishfile; fisher
copy

List installed plugins
$ fisher ls
copy

Update plugins
$ fisher update
copy

Remove one or more plugins
$ fisher remove [plugin1] [plugin2]
copy

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.

SEE ALSO

fish(1), git(1)

Copied to clipboard