Tide
Modern Fish prompt inspired by Powerlevel10k.
Official WebsiteFeatures
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.
# Install Tide using Fisher
fisher install IlanCosman/tide
# You'll be prompted to run the configuration wizard
# If not, run it manually:
tide configureRequirements:
# 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 fontBasic Usage
After installation, Tide will be active. Run the configuration wizard to customize it:
Configuration Wizard
# 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 symbolsWhat Tide Shows
Tide can display:
# 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 symbolsConfiguration
Tide stores configuration in a universal variable. You can modify it or use the wizard.
Viewing 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
# 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 # millisecondsExample 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:
# 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 -fvReconfigure Anytime
Don't like your current configuration? Just run the wizard again:
# Re-run the configuration wizard
tide configure
# Reset to default
set -e tide_* # Clear all tide variables
fisher remove IlanCosman/tide
fisher install IlanCosman/tideGit Status Symbols
Understanding Tide's Git status indicators:
# Git status symbols (may vary by theme)
# = staging area
# ~ conflicted
# + added
# - deleted
# / renamed
# ! modified
# ? untracked
# $ stashed
# ⇡ ahead
# ⇣ behindTroubleshooting
Common issues and solutions:
# 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 gitCombine with Other Plugins
Tide works great with other Fisher plugins. For a shell-agnostic prompt alternative, check out Starship.
# 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