{"id":15692768,"url":"https://github.com/veggiemonk/almostontop-fish","last_synced_at":"2025-07-30T05:35:41.288Z","repository":{"id":77899996,"uuid":"236187569","full_name":"veggiemonk/almostontop-fish","owner":"veggiemonk","description":"Fish shell plugin to keep the input line at the top of the terminal","archived":false,"fork":false,"pushed_at":"2020-02-06T09:08:29.000Z","size":296,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-08T03:46:05.549Z","etag":null,"topics":["ergonomics","fish","fish-plugin","fish-shell","screen","terminal"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/veggiemonk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-01-25T15:22:34.000Z","updated_at":"2024-10-21T03:58:49.000Z","dependencies_parsed_at":"2023-03-12T02:33:52.943Z","dependency_job_id":null,"html_url":"https://github.com/veggiemonk/almostontop-fish","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/veggiemonk/almostontop-fish","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veggiemonk%2Falmostontop-fish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veggiemonk%2Falmostontop-fish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veggiemonk%2Falmostontop-fish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veggiemonk%2Falmostontop-fish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/veggiemonk","download_url":"https://codeload.github.com/veggiemonk/almostontop-fish/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/veggiemonk%2Falmostontop-fish/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267815204,"owners_count":24148360,"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","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ergonomics","fish","fish-plugin","fish-shell","screen","terminal"],"created_at":"2024-10-03T18:40:03.809Z","updated_at":"2025-07-30T05:35:41.263Z","avatar_url":"https://github.com/veggiemonk.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Almostontop for Fish shell\n\n## Description\n\nIt clears the previous command output every time before new command executed in shell.\n\n![demo](tty.gif)\n\n\u003e Using: [iTerm2](https://github.com/gnachman/iTerm2) with status bar enabled and theme [Snazzy](https://github.com/sindresorhus/iterm2-snazzy), [Fira Code font](https://github.com/tonsky/FiraCode), [starship](https://github.com/starship/starship) for the prompt and of course, [fish](https://github.com/fish-shell/fish-shell). Almost no configuration or fine tuning is required!\n\nOnce installed, this plugin creates a function that gets triggered before the execution of the command thanks to the `--on-event fish_preexec`. This event is documented [here](https://fishshell.com/docs/current/commands.html#function).\nThe function clears the previous command output and redraws the `fish_prompt` with the executed command.\n\n## Why\n\nErgonomics.\n\nOn a laptop, bending in order to look down at the bottom of the screen might cause problems to the neck.\nIf, like me, your vision is not 100%, this can help when staring at the terminal for extended period of time.\n\n## Origin\n\nInspired by [almostontop](https://github.com/Valiev/almostontop) plugin for zsh by [Valiev](https://github.com/Valiev/almostontop)\nwhich is inspired by [alwaysontop](https://github.com/swirepe/alwaysontop) plugin for bash by [swirepe](https://github.com/swirepe).\n\n## Installation\n\nSuggestion: Use [fisher](https://github.com/jorgebucaran/fisher) which is a very clean and easy way to manage plugins.\n\n```fish\nfisher add veggiemonk/almostontop-fish\n```\n\nOr install it manually\n\n```fish\ncurl https://raw.githubusercontent.com/veggiemonk/almostontop-fish/master/conf.d/almostontop.fish --create-dirs -sLo ~/.config/fish/conf.d/almostontop.fish\n```\n\n## Usage\n\nThe plugin is automatically load as it is located in `~/.config/fish/conf.d/`\n\n### Deactivate\n\nTo deactivate the plugin in the current session, remove the function:\n\n```fish\nfunctions -e almostontop\n```\n\n### Reactivate\n\nTo reactivate the plugin, open a new shell or `source` the code :\n\n```fish\nsource ~/.config/fish/conf.d/almostontop.fish\n```\n\n### To install fish shell\n\nCheck \u003chttps://fishshell.com\u003e\n\nor\n\n```fish\nbrew install fish\necho /usr/local/bin/fish | sudo tee -a /etc/shells\nchsh -s /usr/local/bin/fish # set it as the default shell\n```\n\n## Removing the plugin\n\n```fish\nfisher rm veggiemonk/almostontop-fish\n\n# or\n\nrm ~/.config/fish/conf.d/almostontop.fish\n```\n\n## Implementation\n\nIf you don't want to install the plugin, just copy-paste these 5 lines into your `config.fish`. Although, it is better to put it in `conf.d` folder.\n\n```fish\nfunction almostontop --on-event fish_preexec\n    clear\n    fish_prompt  # draw prompt\n    echo $argv[1] | fish_indent --ansi # colorize executed command\nend\n```\n\n## TODO\n\nImplementing a toogle feature.\n\nAlthough I've never used that feature, so this feature might never be implement.\nComments, ideas or pull requests are very much appreciated. :D\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveggiemonk%2Falmostontop-fish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fveggiemonk%2Falmostontop-fish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveggiemonk%2Falmostontop-fish/lists"}