How do I install Tide without using Fisher?

Use the manual installation script from the README, which involves downloading a tarball and copying files, but it's noted that this may not work for all use cases and requires careful execution.

Can I use Tide with Bash or Zsh?

No, Tide is built specifically for the Fish shell and relies on Fish's syntax and ecosystem. For other shells, consider cross-shell prompts like Starship or shell-specific options like Powerlevel10k for Zsh.

How do I customize the prompt items in Tide?

Run `tide configure` for an interactive wizard, or directly edit the `items` list in the configuration files as detailed in the wiki, giving you control over which sections display on each side.

What's the difference between Tide and Starship?

Tide is Fish-specific with asynchronous rendering and deep Fish integration, while Starship is cross-shell but may have less Fish-optimized performance. Tide aims to replicate Powerlevel10k's features for Fish users.

How do I fix font issues in my terminal with Tide?

Install a Nerd Font like Meslo Nerd Font by downloading the TTF files and enabling it in your terminal settings, as Tide requires these fonts for icons and symbols to display correctly.

Is Tide compatible with older versions of Fish?

Tide requires Fish 4.0.2 or later; older versions may not work, and the wiki provides compatibility notes, but upgrading is recommended for full functionality.

How to create a custom prompt item in Tide?

You can write your own Fish functions and integrate them into Tide's item system, with the README encouraging contributions and pull requests for new items, though specific guidelines are in the wiki.

Tide — Fast & Friendly Fish Shell Prompt

What is Tide?

Tide is a prompt for the Fish shell that provides a fast, flexible, and user-friendly terminal interface. It solves the problem of slow or unresponsive prompts by using asynchronous rendering and offers an interactive configuration wizard for easy customization. The prompt intelligently displays information like Git status and directory paths while remaining responsive in any situation.

Target Audience

Fish shell users who want a highly customizable, fast, and feature-rich terminal prompt. It's particularly suited for developers who work in Git repositories and need detailed status information without sacrificing performance.

Value Proposition

Developers choose Tide for its pure-Fish construction, which ensures seamless integration and extensibility, combined with asynchronous rendering that keeps the prompt snappy even with complex computations. The interactive configuration wizard makes it exceptionally user-friendly compared to manually editing prompt configuration files.

🌊 The ultimate Fish prompt.

Use Cases

Best For

Fish shell users wanting a responsive and customizable prompt
Developers who need detailed Git status information in their prompt
Users who prefer an interactive wizard for prompt configuration
Those who want to extend their prompt with custom items
Terminal users working in deep directory structures
Anyone seeking a Powerlevel10k-like experience for Fish shell

Not Ideal For

Users running shells other than Fish, such as Bash or Zsh
Terminal setups where Nerd Fonts cannot be installed or are undesirable
Developers who prefer minimal, zero-configuration prompts without additional dependencies
Environments using older versions of Fish shell (pre-4.0.2) without upgrade options

Pros & Cons

Pros

Asynchronous Responsiveness

Background processing ensures the prompt remains snappy even when computing complex Git status, as shown in the async rendering feature that avoids slowdowns from untracked or modified file counts.

Interactive Configuration Wizard

The `tide configure` command provides a user-friendly, terminal-based interface for designing prompts efficiently, eliminating the need for manual file edits.

Flexible Item System

Full control over prompt sections via the `items` list allows customizable layouts and content placement, as demonstrated in the flexible feature with side-by-side examples.

Smart Directory Display

Intelligently truncates and highlights critical path segments to fit limited space while preserving usability, such as bolding important parts like Git roots and using unique prefixes.

Cons

Nerd Font Dependency

Requires a Nerd Font for proper glyph display, which may not be available or configurable in all terminal environments, as specified in the installation prerequisites.

Fish Version Lock-in

Only compatible with the latest Fish shell version (4.0.2), limiting usability for users on older or different versions, with compatibility issues noted in the system requirements.

Manual Setup Complexity

The manual installation script is admitted to potentially not work for all use cases, adding hurdles for users who avoid package managers like Fisher.

Limited Shell Support

Exclusively designed for Fish shell, making it unsuitable for users of Bash, Zsh, or other shells, with no cross-shell alternatives offered.

Frequently Asked Questions

What is Tide?

Target Audience

Value Proposition

Use Cases

Best For

Fish shell users wanting a responsive and customizable prompt
Developers who need detailed Git status information in their prompt
Users who prefer an interactive wizard for prompt configuration
Those who want to extend their prompt with custom items
Terminal users working in deep directory structures
Anyone seeking a Powerlevel10k-like experience for Fish shell

Not Ideal For

Users running shells other than Fish, such as Bash or Zsh
Terminal setups where Nerd Fonts cannot be installed or are undesirable
Developers who prefer minimal, zero-configuration prompts without additional dependencies
Environments using older versions of Fish shell (pre-4.0.2) without upgrade options

Pros & Cons

Pros

Asynchronous Responsiveness

Background processing ensures the prompt remains snappy even when computing complex Git status, as shown in the async rendering feature that avoids slowdowns from untracked or modified file counts.

Interactive Configuration Wizard

The `tide configure` command provides a user-friendly, terminal-based interface for designing prompts efficiently, eliminating the need for manual file edits.

Flexible Item System

Full control over prompt sections via the `items` list allows customizable layouts and content placement, as demonstrated in the flexible feature with side-by-side examples.

Smart Directory Display

Intelligently truncates and highlights critical path segments to fit limited space while preserving usability, such as bolding important parts like Git roots and using unique prefixes.

Cons

Nerd Font Dependency

Requires a Nerd Font for proper glyph display, which may not be available or configurable in all terminal environments, as specified in the installation prerequisites.

Fish Version Lock-in

Only compatible with the latest Fish shell version (4.0.2), limiting usability for users on older or different versions, with compatibility issues noted in the system requirements.

Manual Setup Complexity

The manual installation script is admitted to potentially not work for all use cases, adding hurdles for users who avoid package managers like Fisher.

Limited Shell Support

Exclusively designed for Fish shell, making it unsuitable for users of Bash, Zsh, or other shells, with no cross-shell alternatives offered.

Frequently Asked Questions

Tide

What is Tide?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

Tide

What is Tide?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?