and9527 / awesome-fish

A curated list of packages, prompts, and resources for the amazing fish shell

Awesome Fish

A curation of the greatest packages, prompts, and resources for the fish shell. Built something awesome and want to contribute? Fork this repository, add your project and send us a PR. If you see a project here that is not maintained or is not a good fit, help us improve this file.

This work is donated to the public domain under the CC0 Public Domain Dedication.

Table of Contents

• Package Management
• Prompts
• Utilities
  • Environment
  • Key Bindings
  • Node.js
  • Python
  • Git
  • Testing
• Resources
  • Articles
  • Community
  • Learning

Package Management

• Fisher - Zero configuration universal package manager
• Fundle - Configuration-based package loader—for Vundle.vim fans
• Oh My Fish - Oh My Zsh meets fish~!

✋ Need help choosing?

Prompts

• fishpkg/fish-prompt-metro - git-aware, space-conscious, powerline prompt
• hauleth/agnoster - Solarized, git-aware, powerline prompt
• matchai/spacefish - Space-themed prompt for astronauts
• oh-my-fish/theme-bobthefish - Robust, git-aware, powerline prompt
• rafaelrinaldi/pure - Pure-fish port of sindresorhus/pure prompt

Utilities

• franciscolourenco/done - Automatically receive notifications when a long process finish
• jethrokuan/z - Pure-fish rupa/z-like directory jumping
• jorgebucaran/fish-getopts - CLI options parser alternative to the argparse builtin
• jorgebucaran/fish-spark - Pure-fish sparkline generator
• rodrigobdz/fish-apple-touchbar - Customize your Touch Bar in iTerm2

Environment

• danhper/fish-ssh-agent - Utility functions to start your ssh agent
• edc/bass - Make bash utilities usable in fish
• jorgebucaran/fish-bax - Run bash utilities, replaying environment changes in fish without leaving the comfort of your session

Key Bindings

• jethrokuan/fzf - Improved key bindings for junegunn/fzf
• laughedelic/pisces - Autoclose parentheses, braces, quotes and other paired symbols
• oh-my-fish/plugin-bang-bang - bash style history substitution

Node.js

• brigand/fast-nvm-fish - Enhanced nvm wrapper optimized for speed
• FabioAntunes/fish-nvm - Completion-rich, true nvm wrapper
• jorgebucaran/fish-nvm - Pure-fish, no nonsense Node.js version manager

Python

• adambrenecki/virtualfish - A Fish Shell wrapper for Ian Bicking's virtualenv

Git

• joseluisq/gitnow - Command's set to speed up your Git workflow

Testing

• jorgebucaran/fishtape - TAP-based test runner
• matchai/fish-mock - Quick and powerful mocks

Resources

Articles

• The fish shell is awesome by Julia Evans
• A user introduction to the fish shell by Flavio Copes
• Come for the colors and autosuggestions, stay for the sane scripting! by Mark Volkmann

Community

• r/fishshell
• Gitter Channel
• Trending on GitHub
• StackOverflow #fish

Learning

• Try in Browser!
• The Fish Cookbook
• Official Documentation

---

👋 Looking for more? Explore these topics on GitHub