Vertical

A clean and git-aware prompt for the fish shell with a distinct vertical line.

Features

Unique vertical line prompt
Git-aware
Background job status
User and host names
Previous command duration

Requirements

fish (3.0.0 or higher)
git (optional, for git integration)

Installation

Using Fisher

fisher install adamchristiansen/vertical-fish

Configuration

The following options can be overridden by setting the variable. This only needs to be done once, as universal variables are used for all configuration options.

The vertical_clear_configuration command can be used to clear all universal variables. They are reset to their default values the next time that the prompt is run. This affects only universal variables, so any set global variables will still be used.

General

Option	Default	Description
`vertical_newline`	`true`	Insert a newline before the prompt
`vertical_order`	`jobs user host dir git_branch git_status duration vi_mode`	Order to display components
`vertical_version`	`1.0.0`	Current version

Cue

The cue is displayed immediately before where the user types.

Option	Default	Description
`vertical_cue`	`' '`	Cue text
`vertical_cue_color`	`normal`	Cue color

Option	Default	Description
`vertical_dir_color`	`blue --bold`	Directory color
`vertical_dir_prefix`	`' '`	Directory prefix
`vertical_dir_prefix_color`	`blue --bold`	Directory prefix color
`vertical_dir_trunc_git`	`true`	Shorten directory relative to git repository
`vertical_dir_trunc_home`	`true`	Replace `$HOME` with `~`

Duration

Option	Default	Description
`vertical_duration_color`	`yellow --bold`	Duration color
`vertical_duration_min`	`5000`	Minimum command duration (milliseconds)
`vertical_duration_prefix`	`' '`	Duration prefix
`vertical_duration_prefix_color`	`yellow --bold`	Duration prefix color

Git Branch

Option	Default	Description
`vertical_git_branch_color`	`magenta --bold`	Git branch color
`vertical_git_branch_prefix`	`' '`	Git branch prefix
`vertical_git_branch_prefix_color`	`magenta --bold`	Git branch prefix color

Git Status

Option	Default	Description
`vertical_git_status_color`	`cyan --bold`	Git status color
`vertical_git_status_prefix`	`' ['`	Git status prefix
`vertical_git_status_prefix_color`	`cyan --bold`	Git status prefix color
`vertical_git_status_suffix`	`]`	Git status suffix
`vertical_git_status_suffix_color`	`cyan --bold`	Git status suffix color
`vertical_git_status_sym_added`	`+`	Git added status symbol
`vertical_git_status_sym_added_deleted`	`±`	Git added and deleted status symbol
`vertical_git_status_sym_ahead`	`↑`	Git ahead status symbol
`vertical_git_status_sym_behind`	`↓`	Git behind stymbol
`vertical_git_status_sym_diverged`	`↕`	Git diverged status symbol
`vertical_git_status_sym_deleted`	`-`	Get deleted status symbol
`vertical_git_status_sym_modified`	`•`	Git modified status symbol
`vertical_git_status_sym_renamed`	`‣`	Git renamed status symbol
`vertical_git_status_sym_stashed`	`#`	Git stashed status symbol
`vertical_git_status_sym_unmerged`	`=`	Git unmerged status symbol
`vertical_git_status_sym_untracked`	`?`	Git untracked status symbol

Host

Option	Default	Description
`vertical_host_color`	`yellow --bold`	Host color
`vertical_host_prefix`	`@`	Host prefix
`vertical_host_prefix_color`	`yellow --bold`	Host prefix color
`vertical_host_ssh_only`	`true`	Show only over SSH

Jobs

Option	Default	Description
`vertical_jobs_color`	`cyan --bold`	Jobs color
`vertical_jobs_prefix`	`' '`	Jobs prefix
`vertical_jobs_prefix_color`	`cyan --bold`	Jobs prefix color
`vertical_jobs_sym`	`●`	Jobs symbol

User

Option	Default	Description
`vertical_user_color`	`yellow --bold`	User color
`vertical_user_prefix`	`' '`	User prefix
`vertical_user_prefix`	`yellow --bold`	User prefix color
`vertical_user_ssh_only`	`true`	Show only over SSH

Vertical Bar

Option	Default	Description
`vertical_vert_bottom`	`│`	Vertical bottom symbol
`vertical_vert_color_success`	`green`	Vertical color when the previous command succeeds
`vertical_vert_color_failure`	`red`	Vertical color when the previous command fails
`vertical_vert_top`	`│`	Vertical top symbol

VI Mode

Option	Default	Description
`vertical_vi_mode_color`	`yellow --bold`	VI mode color
`vertical_vi_mode_prefix`	`''`	VI mode prefix
`vertical_vi_mode_prefix_color`	`yellow --bold`	VI mode prefix color
`vertical_vi_mode_sym_insert`	`''`	VI insert mode symbol
`vertical_vi_mode_sym_normal`	`' (N)'`	VI normal mode symbol
`vertical_vi_mode_sym_replace_one`	`' (R)'`	VI replace one mode symbol
`vertical_vi_mode_sym_visual`	`' (V)'`	VI visual mode symbol

adamchristiansen/vertical-fish