⬆️ Hey! Want to migrate from v3.x to v4.x? Check our migration guide, done with :heart

pure

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

🚀 Install

⚠️ requirements: fish ≥3.x

Fisher

fisher install pure-fish/pure

Manually

Via cURL:

# Download the installer to `/tmp`
curl git.io/pure-fish --output /tmp/pure_installer.fish --location --silent
# Source and trigger the installer
source /tmp/pure_installer.fish; and install_pure

Features

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) 🏳️ ;
• Display current directory tail ;
• 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 VI mode and custom symbol for non-insert mode 🏳️ ;
• Show system time 🏳️ ;
• 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) ;
• Update terminal title with current folder and command ;

🖌 Configuration

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

set --universal pure_show_system_time true
set --universal pure_color_system_time pure_color_mute

or changing the defaults in your config.fish, e.g.:

_pure_set_default pure_show_system_time false
_pure_set_default pure_color_system_time grey --reverse

Prompt Symbol

ℹ️ Need safer git symbols?

🔌 Features' Flags

🎨 Colours

ℹ️ See set_color documentation for full possibilities.

⚠️ The absence of $ sign is expected in pure_ named colours.

👍 Contribute

requirements: docker (isolate from your environment)

Specify the FISH_VERSION you want, and the CMD executed by the container:

make build-pure-on FISH_VERSION=3.1.2
make dev-pure-on FISH_VERSION=3.1.2 CMD="fishtape tests/*.test.fish"

👨‍💻 Maintainer

• Édouard Lopez

👏 Thanks

• @andreiborisov for the docker images ;
• @jorgebucaran for fishtape ;
• @rafaelrinaldi for starting the project ;

🏛 License

MIT