IlanCosman/tide
1
1
Fork 0
mirror of https://github.com/IlanCosman/tide.git synced 2024-09-19 21:27:28 +03:00
Code Issues Projects Releases Wiki Activity
🌊 The ultimate Fish prompt.
280 Commits 10 Branches 56 Tags 11 MiB
Shell 99.3%
Makefile 0.7%
8b4cb4dac6
Go to file
Ilan Cosman 8b4cb4dac6 Move documentation to its own section
2020-07-23 20:27:51 -07:00
.github Exchange short flags for long ones 2020-07-20 14:11:59 -07:00
completions Exchange short flags for long ones 2020-07-20 14:11:59 -07:00
conf.d Exchange short flags for long ones 2020-07-20 14:11:59 -07:00
functions Minor edits 2020-07-23 11:33:51 -07:00
tide_theme Renovate tide help command 2020-07-23 10:57:40 -07:00
tools Exchange short flags for long ones 2020-07-20 14:11:59 -07:00
CODE_OF_CONDUCT.md Minor edits 2020-07-04 14:01:35 -07:00
CONTRIBUTING.md Minor edits 2020-07-23 11:33:51 -07:00
LICENSE.md Convert license to markdown 2020-07-04 13:53:26 -07:00
README.md Move documentation to its own section 2020-07-23 20:27:51 -07:00

README.md

Tide Logo

ci_badge ​ fish_version_badge ​ license_badge

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: 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

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

Documentation

See the wiki for the full 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.