Terminal GuideTerminal Guide
tide icon

Tide

Shell Enhancements
macOSLinux
Fish

Modern Fish prompt inspired by Powerlevel10k.

Official Website

Features

Async RenderingConfiguration WizardGit IntegrationFast

Why use Tide?

Beautiful by Default

Modern design inspired by Powerlevel10k with eye-catching colors and informative sections.

Blazingly Fast

Async rendering keeps your shell responsive. Git status checks run in the background.

Interactive Wizard

Configuration wizard makes it easy to customize your prompt without manually editing files.

Git Integration

Shows branch name, status, and commits ahead/behind. Perfect for developers.

Installation

Tide is a prompt theme for Fish Shell that requires the Fisher plugin manager. If you don't have Fisher installed, install it first.

Installation
# Install Tide using Fisher
fisher install IlanCosman/tide

# You'll be prompted to run the configuration wizard
# If not, run it manually:
tide configure

Requirements:

Requirements
# Required:
# - Fish 3.1.2+
# - Fisher (plugin manager)
# - Nerd Font (for icons)

# Check Fish version
fish --version

# Install Nerd Font (recommended: JetBrainsMono Nerd Font)
# Download from https://www.nerdfonts.com/
# Then set it as your terminal font

Basic Usage

After installation, Tide will be active. Run the configuration wizard to customize it:

Configuration Wizard

Configuration
# Launch the interactive configuration wizard
tide configure

# This will ask you to choose:
# - Colors (light/dark background)
# - Prompt layout (one/two lines)
# - What to show (Git status, current time, etc.)
# - Terminal colors
# - Nerd Font symbols

What Tide Shows

Tide can display:

Tide display elements
# Current directory
# Git branch and status
# Command execution time
# Exit status
# Background jobs indicator
# Node.js version (in node projects)
# Python version (in python projects)
# Virtual environment name
# Custom colors and symbols

Configuration

Tide stores configuration in a universal variable. You can modify it or use the wizard.

Viewing Configuration

View configuration
# Show current Tide configuration
tide_theme

# Tide uses these universal variables:
set tide_theme_name 'Catppuccin Frappé'
set tide_pwd_untruncated_home true
set tide_git_truncation_length 10
set tide_left_prompt_items 'pwd' 'git'
set tide_right_prompt_items 'status' 'cmd_duration'

Manual Configuration

Manual configuration
# Set tide theme
set -U tide_pwd_markers '.git' '.hg' '.svn'
set -U tide_pwd_untruncated_home true

# Show git status
set -U tide_git_show_status_enabled true

# Customize left prompt items
set -U tide_left_prompt_items pwd git newline character

# Customize right prompt items
set -U tide_right_prompt_items status cmd_duration background_jobs nvm virtual_env time

# Set color theme (after running configure, colors are set)
set -U tide_theme_name 'Catppuccin Frappé'

# Show command duration
set -U tide_cmd_duration_threshold 3000  # milliseconds

Example Complete Setup

Complete setup
# Install Tide
fisher install IlanCosman/tide

# Run configuration
tide configure

# Add to ~/.config/fish/config.fish if you want persistent custom settings:

# Optional: Enable additional items
set -U tide_right_prompt_items status cmd_duration background_jobs nvm virtual_env time

# Optional: Set timezone for time display
set -U tide_time_format '%H:%M'

# Optional: Git configuration
set -U tide_git_truncation_length 20
set -U tide_git_untracked_enabled true

# Your aliases and other config
abbr -a gs 'git status'
abbr -a ga 'git add'
abbr -a gc 'git commit -m'
abbr -a gp 'git push'
abbr -a gl 'git log --oneline -n 10'

Tips & Tricks

Font Installation

Tide displays best with a Nerd Font. Here's how to set it up:

Install Nerd Font
# macOS - Install JetBrainsMono Nerd Font via Homebrew
brew tap homebrew/cask-fonts
brew install --cask font-jetbrains-mono-nerd-font

# Then set it in your terminal preferences
# iTerm2: Preferences > Profiles > Text > Font
# Terminal: Preferences > Profiles > Font

# Linux: Download from https://www.nerdfonts.com/
# Then copy .ttf files to ~/.local/share/fonts/
# Run: fc-cache -fv

Reconfigure Anytime

Don't like your current configuration? Just run the wizard again:

Reconfigure
# Re-run the configuration wizard
tide configure

# Reset to default
set -e tide_*  # Clear all tide variables
fisher remove IlanCosman/tide
fisher install IlanCosman/tide

Git Status Symbols

Understanding Tide's Git status indicators:

Git symbols
# Git status symbols (may vary by theme)
# = staging area
# ~ conflicted
# + added
# - deleted
# / renamed
# ! modified
# ? untracked
# $ stashed
# ⇡ ahead
# ⇣ behind

Troubleshooting

Common issues and solutions:

Troubleshooting
# Icons appear as boxes
# Solution: Install and select a Nerd Font

# Prompt is slow
# Solution: Run 'tide configure' and adjust git settings

# Colors look wrong
# Solution: Check your terminal color profile
# Set your terminal to use 256 colors or true color

# Missing Git info
# Solution: Make sure Git is installed and in PATH
which git

Combine with Other Plugins

Tide works great with other Fisher plugins. For a shell-agnostic prompt alternative, check out Starship.

Compatible plugins
# Recommended plugins to use with Tide
fisher install jethrokuan/z              # Jump to directories
fisher install PatrickF1/fzf.fish        # Fuzzy finder
fisher install edc/bass                  # Run bash scripts
fisher install franciscolourenco/done    # Notifications
fisher install oh-my-fish/plugin-git     # Git shortcuts

# These don't interfere with Tide and enhance productivity
Written by Dai AokiPublished: 2026-01-20

Related Articles

Explore More