tide/README.md
2020-07-23 09:12:08 -07:00

4.9 KiB
Raw Blame History

Configuration Wizard

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: Make all your Fish friends jealous 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

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.

configuration_wizard

Multi-Line Right Prompt

Fish can't do that yet can it?

multi-line_right_prompt

Pure Compatibility

Tide can produce the same prompt as Pure. Type tide configure and select the Pure style.

pure_compatibility

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!

extensible

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.