Skip to content

Pure.fish Documentation

Home

ci-status

release-version

sponsors

Pure `❯❮❯`¶

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

Pure with dark colorscheme

Pure with light colorscheme

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

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

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 ❯ 🛠:
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 simplifies 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, 🛠 means it's configurable.