+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
#742fisher blocks GitHub Codespaces personalized dotfile setup14 comments · 2022-10-18#770Feature request: option to force overwrite existing files9 comments · 2023-08-02#788Get selected version in plugin event handlers7 comments · 2024-04-06#763Feature request: add a command to only install packages that are missing4 comments · 2023-05-26#835Unable to install a private plugin2 comments · 2026-07-31#833FR: Add a --force-clobber (or similar) flag to fisher-install2 comments · 2026-05-14#838Host unavailable during installtion1 comments · 2026-09-18#816Symlinked home directory causes fisher to modify fish_plugins in non-portable way1 comments · 2025-12-05
Latest release
4.4.8 4.4.8 2026-01-25- Add uninstall as an alias to remove by @technicalpickles (807).