.github | ||
completions | ||
conf.d | ||
functions | ||
tide_theme | ||
tools | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE.md | ||
README.md |
A modern prompt manager for the Fish shell.
- Configuration Wizard: With four compelling styles and myriad options, you can have your out-of-the-box cake and customize it too.
- Flexible: One line, two line, powerline, all fine!
- Multi-line right prompt: Impress all your Fish friends with this alien technology.
- Intelligent: Shows relevant information at a glance, emphasizing important material.
- Extensible: Easily add prompt items by creating simple fish functions.
Installation
Prerequisites
- Git
- Fish ≥ 3.1
- A Nerd Font installed and enabled in your terminal (for example the reccomended font).
Source and run the install function
curl -sL git.io/tide | source && tide_install
Features
Configuration Wizard
Type tide configure
to open the the wizard in your terminal.
Multi-Line Right Prompt
Fish can't do that yet can it?
Pure Emulation
Tide can easily produce the same prompt as Pure. Type tide configure
and select the Pure style.
Tide doesn't recognize Pure configuration parameters, so you'll need to use set tide_cmd_duration_threshold 3000
instead of set pure_threshold_command_duration 3
, etc.
Pure style is an exact replication of the Pure fish theme and therefore displays less information than Lean. It exists only to ease the migration for users of that theme. Unless you are one of them, choose Lean style over Pure.
Extensible
If there isn't a prompt item that fits your needs, make your own!
Documentation
See the wiki for the boring parts of the documentation.
Contributing
If you're interested in helping contribute to Tide, please take a look at the Contributing Guide.
Fonts
Meslo Nerd Font
Gorgeous monospace font designed by Jim Lyles for Bitstream, customized for Apple, enhanced by André Berg, and finally patched by Roman Perepelitsa of Powerlevel10k with scripts originally developed by Ryan McIntyre of Nerd Fonts. Contains all the glyphs and symbols that Tide may need. Battle-tested in dozens of different terminals on all major operating systems.
Font Installation
Download these four ttf files:
Open each file and click "Install". This will make the MesloLGS NF
font available to all applications on your system. Configure your terminal to use this font.
Acknowledgments
- Powerlevel10k - Inspired much of Tide's documentation, resources, ideas, and design.
- Starship - Inspired elements of the documentation.