Ultra-pure, lag-free prompt with async Git status. Designed for Fish.


Install with Fisher:

fisher install jorgebucaran/hydro


One prompt symbol to rule them all. Change it.

~ ❱ ⎢

Show Git branch name and status—prompt repaints asynchronously! ✨

~/p/hydro main ❱ touch Solution
~/p/hydro main• ❱ ⎢

indicates that there are staged, unstaged or untracked files.

Show how many commits you're ahead and/or behind of your upstream—prompt repaints asynchronously! ✨

~/p/hydro main• ↓2 ❱ git commit -am Hotfix
~/p/hydro main ↑1 ↓2 ❱ git pull --rebase && git push
~/p/hydro main ❱ ⎢

Show $CMD_DURATION if > 1 second.

~/p/hydro main ❱ git push --quiet
~/p/hydro main 1.1s ❱ ⎢

Show the last $pipestatus.

~/p/hydro main ❱ false
~/p/hydro main ❱ [1]
~/p/hydro main ❱ true | false | false
~/p/hydro main [0ǀ1ǀ1] ⎢

Truncate $PWD segments except for the basename and root of Git repos.

~ ❱ projects/hydro/
~/p/hydro ❱ functions/share/
~/p/hydro/f/share ❱ ⎢

Show current bindings mode.

I ~Esc
N ~R
R ~ ❱ ⎢

We even set the terminal title to $PWD and the currently running command for you.

fish ~/projects/hydro


Blazing fast would be an understatement considering that the LLVM repo has over 375,000 commits!

~/llvm-project main ❱ time fish_prompt
~/llvm-project main ❱
Executed in   79.00 micros    fish           external
   usr time   71.00 micros   71.00 micros    0.00 micros
   sys time    9.00 micros    9.00 micros    0.00 micros


Modify variables using set --universal from the command line or set --global in your config.fish file.


Variable Type Description Default
hydro_symbol_prompt string Prompt symbol.
hydro_symbol_git_dirty string Dirty repository symbol.
hydro_symbol_git_ahead string Ahead of your upstream symbol.
hydro_symbol_git_behind string Behind of your upstream symbol.


Any argument accepted by set_color.

Variable Type Description Default
hydro_color_pwd color Color of the pwd segment. $fish_color_normal
hydro_color_git color Color of the git segment. $fish_color_normal
hydro_color_error color Color of the error segment. $fish_color_error
hydro_color_prompt color Color of the prompt symbol. $fish_color_normal
hydro_color_duration color Color of the duration section. $fish_color_normal


Variable Type Description Default
hydro_fetch boolean Fetch git remote in the background. false




Ultra-pure, lag-free prompt with async Git status. Designed for Fish.

Hydro Info

⭐ Stars 270
🔗 Source Code github.com
🕒 Last Update 8 months ago
🕒 Created 4 years ago
🐞 Open Issues 3
➗ Star-Issue Ratio 90
😎 Author jorgebucaran