Awesome
<i>H</i>ydro
Ultra-pure, lag-free prompt with async Git status. Designed only for Fish.
Installation
Install with Fisher:
fisher install jorgebucaran/hydro
Features
One prompt symbol to rule them all. Change it?
<pre> <b>~</b> ❱ ⎢ </pre>Display Git branch name and status—prompt repaints asynchronously! ✨
<pre> ~/p/<b>hydro</b> main ❱ touch Solution ~/p/<b>hydro</b> main• ❱ ⎢ </pre>
•indicates that there are staged, unstaged or untracked files.
Display how many commits ahead and/or behind you are of your upstream—prompt repaints asynchronously!
<pre> ~/p/<b>hydro</b> main• ↓2 ❱ git commit -am Hotfix ~/p/<b>hydro</b> main ↑1 ↓2 ❱ git pull --rebase && git push ~/p/<b>hydro</b> main ❱ ⎢ </pre>Display $CMD_DURATION when > 1 second. Configurable.
Display the last non-zero exit status (or statuses) using $pipestatus.
Truncate $PWD segments except for the basename and root of Git repos.
Display the current bindings mode.
<pre> <i>I</i> <b>~</b> ❱ <kbd>Esc</kbd> <i>N</i> <b>~</b> ❱ <kbd>R</kbd> <i>R</i> <b>~</b> ❱ ⎢ </pre>Performance
Blazing fast would be an understatement considering that the LLVM repo has over 375,000 commits!
<pre> ~/<b>llvm-project</b> main ❱ time fish_prompt ~/<b>llvm-project</b> 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 </pre>Configuration
Modify variables using set --universal from the command line or set --global in your config.fish file.
Symbols
| Variable | Type | Description | Default |
|---|---|---|---|
hydro_symbol_start | string | Prompt start symbol. | |
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. | ↓ |
Colors
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_start | color | Color of the start symbol. | $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 |
Flags
| Variable | Type | Description | Default |
|---|---|---|---|
hydro_fetch | boolean | Fetch git remote in the background. | false |
hydro_multiline | boolean | Display prompt character on a separate line. | false |
Misc
| Variable | Type | Description | Default |
|---|---|---|---|
fish_prompt_pwd_dir_length | numeric | The number of characters to display when path shortening. Set it to 0 to display only the topmost (current) directory. | 1 |
hydro_ignored_git_paths | strings | Space separated list of paths where no git info should be displayed. | "" |
hydro_cmd_duration_threshold | numeric | Minimum command duration, in milliseconds, after which command duration is displayed. | 1000 |