{"id":13469063,"url":"https://github.com/jorgebucaran/hydro","last_synced_at":"2025-04-04T10:08:00.388Z","repository":{"id":37050365,"uuid":"166628414","full_name":"jorgebucaran/hydro","owner":"jorgebucaran","description":"Ultra-pure, lag-free prompt with async Git status—just for Fish","archived":false,"fork":false,"pushed_at":"2024-04-22T11:07:50.000Z","size":137,"stargazers_count":587,"open_issues_count":13,"forks_count":50,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-05-02T05:31:15.797Z","etag":null,"topics":["async","fish","fish-plugin","fish-prompt"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jorgebucaran.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-20T05:55:04.000Z","updated_at":"2024-05-05T07:26:52.789Z","dependencies_parsed_at":"2022-08-05T14:00:55.048Z","dependency_job_id":"ff163814-3c5f-4ab2-9b4a-916b763b879a","html_url":"https://github.com/jorgebucaran/hydro","commit_stats":{"total_commits":125,"total_committers":8,"mean_commits":15.625,"dds":0.08799999999999997,"last_synced_commit":"bc31a5ebc687afbfb13f599c9d1cc105040437e1"},"previous_names":["foldmap/hydro","srcfile/hydro","joxji/hydro","jorgebucaran/hydro"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebucaran%2Fhydro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebucaran%2Fhydro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebucaran%2Fhydro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebucaran%2Fhydro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jorgebucaran","download_url":"https://codeload.github.com/jorgebucaran/hydro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157283,"owners_count":20893220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","fish","fish-plugin","fish-prompt"],"created_at":"2024-07-31T15:01:25.471Z","updated_at":"2025-04-04T10:08:00.363Z","avatar_url":"https://github.com/jorgebucaran.png","language":"Shell","funding_links":[],"categories":["Shell","Fish","Prompts","Packages"],"sub_categories":["Prompts"],"readme":"# \u003ci\u003eH\u003c/i\u003eydro\n\n\u003e Ultra-pure, lag-free prompt with async Git status. Designed only for [Fish](https://fishshell.com).\n\n[![](https://user-images.githubusercontent.com/56996/103166797-f807ee00-4868-11eb-9818-c661584274c8.gif)](#hydro)\n\n## Installation\n\nInstall with [Fisher](https://github.com/jorgebucaran/fisher):\n\n```console\nfisher install jorgebucaran/hydro\n```\n\n## Features\n\nOne prompt symbol to rule them all. [Change it](#configuration)?\n\n\u003cpre\u003e\n\u003cb\u003e~\u003c/b\u003e ❱ ⎢\n\u003c/pre\u003e\n\nDisplay Git branch name and status—prompt repaints asynchronously! ✨\n\n\u003cpre\u003e\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ❱ touch Solution\n~/p/\u003cb\u003ehydro\u003c/b\u003e main• ❱ ⎢\n\u003c/pre\u003e\n\n\u003e `•` indicates that there are staged, unstaged or untracked files.\n\nDisplay how many commits ahead and/or behind you are of your upstream—prompt repaints asynchronously!\n\n\u003cpre\u003e\n~/p/\u003cb\u003ehydro\u003c/b\u003e main• ↓2 ❱ git commit -am Hotfix\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ↑1 ↓2 ❱ git pull --rebase \u0026\u0026 git push\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ❱ ⎢\n\u003c/pre\u003e\n\nDisplay [`$CMD_DURATION`](https://fishshell.com/docs/current/language.html?highlight=cmd_duration#envvar-CMD_DURATION) when \u003e `1` second. [Configurable](#configuration).\n\n\u003cpre\u003e\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ❱ git push --quiet\n~/p/\u003cb\u003ehydro\u003c/b\u003e main 1.1s ❱ ⎢\n\u003c/pre\u003e\n\nDisplay the last non-zero [exit status](https://fishshell.com/docs/current/tutorial.html#exit-status) (or statuses) using [`$pipestatus`](https://fishshell.com/docs/current/language.html?highlight=cmd_duration#envvar-pipestatus).\n\n\u003cpre\u003e\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ❱ false\n~/p/\u003cb\u003ehydro\u003c/b\u003e main | \u003cb\u003e1\u003c/b\u003e ❱ ⎢\n~/p/\u003cb\u003ehydro\u003c/b\u003e main ❱ true | false | false\n~/p/\u003cb\u003ehydro\u003c/b\u003e main | \u003cb\u003e0\u003c/b\u003e \u003cb\u003e1\u003c/b\u003e \u003cb\u003e1\u003c/b\u003e ❱ ⎢\n\u003c/pre\u003e\n\nTruncate [`$PWD`](https://fishshell.com/docs/current/language.html?highlight=cmd_duration#envvar-PWD) segments except for the basename and root of Git repos.\n\n\u003cpre\u003e\n\u003cb\u003e~\u003c/b\u003e ❱ projects/hydro/\n~/p/\u003cb\u003ehydro\u003c/b\u003e ❱ functions/share/\n~/p/hydro/f/\u003cb\u003eshare\u003c/b\u003e ❱ ⎢\n\u003c/pre\u003e\n\nDisplay the current bindings mode.\n\n\u003cpre\u003e\n\u003ci\u003eI\u003c/i\u003e \u003cb\u003e~\u003c/b\u003e ❱ \u003ckbd\u003eEsc\u003c/kbd\u003e\n\u003ci\u003eN\u003c/i\u003e \u003cb\u003e~\u003c/b\u003e ❱ \u003ckbd\u003eR\u003c/kbd\u003e\n\u003ci\u003eR\u003c/i\u003e \u003cb\u003e~\u003c/b\u003e ❱ ⎢\n\u003c/pre\u003e\n\n## Performance\n\nBlazing fast would be an understatement considering that the [LLVM repo](https://github.com/llvm/llvm-project) has over 375,000 commits!\n\n\u003cpre\u003e\n~/\u003cb\u003ellvm-project\u003c/b\u003e main ❱ time fish_prompt\n~/\u003cb\u003ellvm-project\u003c/b\u003e main ❱\n________________________________________________________\nExecuted in   79.00 micros    fish           external\n   usr time   71.00 micros   71.00 micros    0.00 micros\n   sys time    9.00 micros    9.00 micros    0.00 micros\n\u003c/pre\u003e\n\n## Configuration\n\nModify variables using `set --universal` from the command line or `set --global` in your `config.fish` file.\n\n### Symbols\n\n| Variable                  | Type   | Description                     | Default |\n| ------------------------- | ------ | ------------------------------- | ------- |\n| `hydro_symbol_start`      | string | Prompt start symbol.            |         |\n| `hydro_symbol_prompt`     | string | Prompt symbol.                  | `❱`     |\n| `hydro_symbol_git_dirty`  | string | Dirty repository symbol.        | `•`     |\n| `hydro_symbol_git_ahead`  | string | Ahead of your upstream symbol.  | `↑`     |\n| `hydro_symbol_git_behind` | string | Behind of your upstream symbol. | `↓`     |\n\n### Colors\n\n\u003e Any argument accepted by [`set_color`](https://fishshell.com/docs/current/cmds/set_color.html).\n\n| Variable               | Type  | Description                    | Default              |\n| ---------------------- | ----- | ------------------------------ | -------------------- |\n| `hydro_color_pwd`      | color | Color of the pwd segment.      | `$fish_color_normal` |\n| `hydro_color_git`      | color | Color of the git segment.      | `$fish_color_normal` |\n| `hydro_color_start`    | color | Color of the start symbol.     | `$fish_color_normal` |\n| `hydro_color_error`    | color | Color of the error segment.    | `$fish_color_error`  |\n| `hydro_color_prompt`   | color | Color of the prompt symbol.    | `$fish_color_normal` |\n| `hydro_color_duration` | color | Color of the duration section. | `$fish_color_normal` |\n\n### Flags\n\n| Variable          | Type    | Description                                  | Default |\n| ----------------- | ------- | -------------------------------------------- | ------- |\n| `hydro_fetch`     | boolean | Fetch git remote in the background.          | `false` |\n| `hydro_multiline` | boolean | Display prompt character on a separate line. | `false` |\n\n### Misc\n\n| Variable                       | Type    | Description                                                                                                              | Default |\n| ------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------ | ------- |\n| `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`     |\n| `hydro_ignored_git_paths`      | strings | Space separated list of paths where no git info should be displayed.                                                     | `\"\"`    |\n| `hydro_cmd_duration_threshold` | numeric | Minimum command duration, in milliseconds, after which command duration is displayed.                                    | `1000`  |\n\n## License\n\n[MIT](LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgebucaran%2Fhydro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjorgebucaran%2Fhydro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgebucaran%2Fhydro/lists"}