Home

Awesome

Bref zsh prompt

A simple zsh prompt. It shows the git status asynchronously, shows a ssh notification if the session is remote, the battery level and the amount of background jobs.

bref prompt

The battery level visibility is toggleable using the BREF_SHOW_BATTERY_BINDING and is remembered for the next zsh sessions.

Installation

Source bref-zsh-prompt.zsh-theme in your .zshrc or use your favorite plugin manager.

More screenshots

SSH notification if the session is remote.

bref prompt ssh

The left part expands when displaying a long path.

bref prompt long path

Configuration

VARIABLEEFFECT
BREF_SHOW_BATTERY_BINDINGThe keybinding used to toggle the battery indicator on/off. Default: '^B' (Ctrl+B).
BREF_GIT_AHEADThe icon to use for the git AHEAD status.
BREF_GIT_BEHINDThe icon to use for the git BEHIND status.
BREF_GIT_MERGINGThe icon to use for the git MERGING status.
BREF_GIT_STAGEDThe icon to use for the git STAGED status.
BREF_GIT_UNTRACKEDThe icon to use for the git UNTRACKED status.
BREF_GIT_MODIFIEDThe icon to use for the git MODIFIED status.
BREF_GIT_STASHEDThe icon to use for the git STASHED status.
BREF_GIT_COLORThe color to use for the git notification in RPROMPT
BREF_CODE_COLORThe color to use for the command return code notification in RPROMPT.
BREF_SSH_COLORThe color to use for the ssh notification in RPROMPT.
BREF_JOBS_COLORThe color to use for the jobs notification in RPROMPT.
BREF_BATTERY_COLORThe color to use for the battery notification in RPROMPT.

You must use zsh prompt expansions (like '%F{red}', '%B', ...) in the BREF_*_COLOR variables. You can also use them in the BREF_GIT_* variables.