IlanCosman/tide
1
1
Fork 0
mirror of https://github.com/IlanCosman/tide.git synced 2024-11-30 15:15:19 +03:00
Code Issues Projects Releases Wiki Activity
🌊 The ultimate Fish prompt.
297 Commits 10 Branches 56 Tags 11 MiB
Shell 99.3%
Makefile 0.7%
a6d5eee879
Go to file
Ilan Cosman a6d5eee879 Fallback to ID_LIKE if ID is unknown
2020-07-29 20:37:02 -07:00
.github Add apt-get update to CI, quiet apt-get output 2020-07-25 18:50:53 -07:00
completions Change basename --suffix= to -s for macos compatability 2020-07-26 23:39:18 -07:00
conf.d Add detect_os and item_os 2020-07-29 20:36:57 -07:00
functions Fallback to ID_LIKE if ID is unknown 2020-07-29 20:37:02 -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 docs: section/info tweaks 2020-07-30 00:40:43 +09:00

README.md

Tide Logo

ci_badge ​ fish_version_badge ​ license_badge

header.png

A modern prompt manager for the Fish shell.

  • Out of the box: With four compelling styles and myriad options, you can have your out-of-the-box cake and customize it too.
  • Flexible: Move content around, remove it, or add it back, all without ever touching a line of code.
  • Powerful: Impress all your Fish friends with alien technologies like a multi-line right prompt.
  • Extensible: Create custom content with simple fish functions that integrate seamlessly.

Installation

System Requirements

Source and run the install function

curl -sL git.io/tide | source && tide_install

Features

Configuration Wizard

Run tide configure to open the the wizard in your terminal.

configuration_wizard


flexible.png

Flexible

Tide uses "items", small functions that create the prompt contents. Using the items list for each side of the prompt, you have full control of where and which items display.



multi-line_right_prompt.png

Multi-Line Right Prompt

Fish can't do that yet can it!

Tide takes care of all the multi-line logic and printing for you. All you have to do is add the newline item.



extensible.png

Extensible

If there isn't an item that fits your needs you can make your own (and hopefully submit a pull request) or ask for it to be made by opening an issue.



pure_emulation.gif

Pure Emulation

Tide can easily produce the same prompt as Pure (with a number of improvements). Run tide configure and select the Pure style.

All of Tide's features are available while using Pure style, though it displays less information by default than Lean style.


Documentation

See the wiki for the full documentation.

Contributing

From the smallest typo to the largest feature, contributions of any size or experience level are welcome!

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.