Pure ❯❮❯

Pretty, minimal and fast Fish 🐟 prompt, ported from zsh.

Install

Requirements

Pure is written in fish language, this requires Fish shell ≥3.x.

using FisherManuallyTest a Pull Request

Install Fisher plugin manager, then you can install pure latest version with:

fisher install pure-fish/pure

1. Download the installer to /tmp

   curl git.io/pure-fish --output /tmp/pure_installer.fish --location --silent
   

2. Source and trigger the installer

   source /tmp/pure_installer.fish; and install_pure
   

Wanna preview a pull-request before it gets merged? Just append @ symbol, followed by a tag, branch, or commit.

fisher install pure-fish/pure@v4.13.0

Configuration

You can tweak pure behavior and color by changing universal variables either directly in the terminal or in your config.fish, e.g.:

# try to change prompt symbol
set --universal pure_symbol_prompt '>>>'
# restore default
set --universal pure_symbol_prompt '❯'

Features

Overview

Fully customizable (colors, symbols and features):

• Excellent prompt character ❯ 🛠:

  • Change ❯ to red when previous command has failed 🛠 ;
  • Start prompt with current working directory 🏴 ;
  • Compact-mode (single-line prompt) 🏴 ;
  • List exit statuses if the last command failed 🏴 ;

• Check for new release on start 🏴🐌 ;

• Display username and hostname when in an SSH session 🛠 ;
• Display command duration when longer than 5 seconds 🛠 ;
• Display Python virtualenv when activated 🏴🛠 ;
• Display AWS profile when set 🏴🛠 ;
• Display VI mode and custom symbol for non-insert mode 🏴🛠 ;
• Display kubernetes context and namespace 🏴🛠 ;
• Detect when running in a container (e.g. docker, podman, LXC/LXD) 🏴🛠
• Indicate if a nix develop shell is activated 🏴🛠.
• Show system time 🏴 ;
• Transient prompt mode simplify previous prompts 🏴 ;
• Show number of running jobs 🏴 ;
• Prefix when root 🏴🛠 ;

• Display git branch name 🏴🛠 ;

  • Display * when git repository is dirty ;
  • Display ≡ when git repository is stashed ;
  • Display ⇡ when branch is ahead (commits to push) ;
  • Display ⇣ when branch is behind (commits to pull) ;
  • Display the number of stashes, ahead and behind commits (e.g. ≡3 ⇡5 ⇣2) ;
  • Async update when configured with fish-async-prompt ;

• Update terminal title with current folder and command 🛠 ;

• Shorten or truncate current folder component 🏴🛠 ;
• and more…

🏴 means it's controlled by a feature flag, 🛠 mean it's configurable.