A fork of the clean and git-aware prompt for the fish shell with a definitive vertical line by Adam Christiansen.
The scope of this fork is to re-order some elements, add suffixes and change some of the looks like colors and when bold vs. non bold text appears.
Reasons why you should use Vertical:
- Features a unique vertical line prompt
- Highly configurable
- Git-aware
- Shows the status of background jobs
- Displays the duration of the previous command
This is what it looks like out of the box:
- fish (v3.0.0 or higher)
Using Fisher
fisher install ellienieuwdorp/vertical-fish
The following options can be overridden in config.fish
. Colors are always
specified as arguments to set_color
. Any of the following that are not set
will be set to the default value.
General
Option | Default | Description |
---|---|---|
VERTICAL_COLOR_NORMAL |
normal |
The default color. |
VERTICAL_NEWLINE |
true |
Inserts a newline before the prompt. |
Directory
Option | Default | Description |
---|---|---|
VERTICAL_DIR_COLOR |
blue --bold |
The directory name color. |
VERTICAL_DIR_PREFIX |
" " |
The directory name prefix. |
VERTICAL_DIR_TRUNC_GIT |
true |
Shorten directory relative to the root of a git repository. |
VERTICAL_DIR_TRUNC_HOME |
true |
Replaces $HOME with ~ . |
Duration
Option | Default | Description |
---|---|---|
VERTICAL_DURATION_COLOR |
yellow --bold |
The duration color. |
VERTICAL_DURATION_MIN |
5000 |
The minimum command duration required to toggle the duration indicator (milliseconds). |
VERTICAL_DURATION_PREFIX |
" " |
The text before the duration. |
VERTICAL_DURATION_SHOW |
true |
Show the duration indicator. |
Git
Option | Default | Description |
---|---|---|
VERTICAL_GIT_BRANCH_COLOR |
magenta --bold |
Git branch color. |
VERTICAL_GIT_BRANCH_PREFIX |
" " |
Git branch prefix. |
VERTICAL_GIT_SHOW |
true |
Show git indicator. |
VERTICAL_GIT_STATUS_COLOR |
cyan --bold |
Git status color. |
VERTICAL_GIT_STATUS_PREFIX |
"[" |
Git status prefix. |
VERTICAL_GIT_STATUS_SHOW |
true |
Show the git status indicator. |
VERTICAL_GIT_STATUS_SUFFIX |
"]" |
Git status suffix. |
VERTICAL_GIT_STATUS_SYM_ADDED |
"+" |
Git added status symbol. |
VERTICAL_GIT_STATUS_SYM_AHEAD |
"↑" |
Git ahead status symbol. |
VERTICAL_GIT_STATUS_SYM_BEHIND |
"↓" |
Git behind status symbol. |
VERTICAL_GIT_STATUS_SYM_DIVERGED |
"⇵" |
Git diverged status symbol. |
VERTICAL_GIT_STATUS_SYM_DELETED |
"-" |
Git 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. |
Jobs
Option | Default | Description |
---|---|---|
VERTICAL_JOBS_COLOR |
cyan --bold |
Jobs indicator color. |
VERTICAL_JOBS_PREFIX |
" " |
Jobs prefix. |
VERTICAL_JOBS_SHOW |
true |
Show jobs indicator. |
VERTICAL_JOBS_SYM |
"●" |
Jobs indicator symbol. |
Prompt
Option | Default | Description |
---|---|---|
VERTICAL_VERT_PROMPT |
" " |
The prompt text. |
VERTICAL_VERT_PROMPT_COLOR |
yellow |
The prompt color. |
Vertical Bar
Option | Default | Description |
---|---|---|
VERTICAL_VERT_PREFIX |
"│" |
The prompt vertical bar. |
VERTICAL_VERT_COLOR_SUCCESS |
green |
The bar color when the previous command succeeds. |
VERTICAL_VERT_COLOR_FAILURE |
red |
The bar color when the previos command fails. |
VI Mode
Option | Default | Description |
---|---|---|
VERTICAL_VI_MODE_COLOR |
yellow --bold |
VI mode color. |
VERTICAL_VI_MODE_SHOW |
true |
Show VI mode indicators. |
VERTICAL_VI_MODE_SYM_INSERT |
"" |
The symbol to show in insert mode. |
VERTICAL_VI_MODE_SYM_NORMAL |
"[N] " |
The symbol to show in normal mode. |
VERTICAL_VI_MODE_SYM_REPLACE_ONE |
"[R] " |
The symbol to show in replace one mode. |
VERTICAL_VI_MODE_SYM_VISUAL |
"[V] " |
The symbol to show in visual mode. |