Home

Awesome

<img src="https://raw.githubusercontent.com/mnml-theme/mnml.github.io/main/img/logo.svg" width="12%" align="right"> <br>

mnml prompt

A minimal Zshell prompt theme.

*Preview shows Dracula theme with JetBrains Mono Nerd font.

Compatible with .files.

Install

with Homebrew:

brew install mnml-theme/install/mnml-prompt

or brew bundle install[ --file] from Brewfile:

tap  "mnml-theme/install"
brew "mnml-prompt"

Then add to your startup files:

# ~/.zshrc
autoload -Uz promptinit
promptinit
prompt mnml

or simply export ZSH_THEME with ZDOTDIR:

# $ZDOTDIR/source/*.env
ZSH_THEME=mnml

Configuration

Environment variableDefault valueDescription
PS1/PROMPTZSH_PROMPT_SYMBOLDefault left aligned prompt.
RPS1/RPROMPTvcs_infoAdditional right aligned prompt.
ZLE_RPROMPT_INDENT0Number of spaces indentation to the right of RPS1/RPROMPT.
ZSH_PROMPT_NEWLINEtrueAdd a newline after each command.
ZSH_PROMPT_SYMBOL_COLORdefaultANSI color of ZSH_PROMPT_SYMBOL.
ZSH_PROMPT_COLOR_ERRORredANSI color of ZSH_PROMPT_SYMBOL_ERROR.
ZSH_PROMPT_COLOR_COMMENT8ANSI bright black by default.
ZSH_PROMPT_COLOR_JOBSZSH_PROMPT_COLOR_COMMENTANSI color of ZSH_PROMPT_SYMBOL_JOBS.
ZSH_PROMPT_COLOR_PWDZSH_PROMPT_COLOR_COMMENTANSI color of ZSH_PROMPT_PWD.
ZSH_PROMPT_COLOR_ADDEDgreenANSI color of ZSH_PROMPT_SYMBOL_ADDED in vcs_info
ZSH_PROMPT_COLOR_UNTRACKEDZSH_PROMPT_COLOR_ADDEDANSI color of ZSH_PROMPT_SYMBOL_UNTRACKED in vcs_info.
ZSH_PROMPT_COLOR_MODIFIEDyellowANSI color of ZSH_PROMPT_SYMBOL_MODIFIED in vcs_info.
ZSH_PROMPT_COLOR_RENAMEDblueANSI color of ZSH_PROMPT_SYMBOL_RENAMED in vcs_info.
ZSH_PROMPT_COLOR_DELETEDZSH_PROMPT_COLOR_ERRORANSI color of ZSH_PROMPT_SYMBOL_DELETED in vcs_info.
ZSH_PROMPT_COLOR_STASHEDZSH_PROMPT_COLOR_JOBSANSI color of ZSH_PROMPT_SYMBOL_STASHED in vcs_info.
ZSH_PROMPT_COLOR_REVISIONZSH_PROMPT_COLOR_STASHEDANSI color of ZSH_PROMPT_SYMBOL_REVISION in vcs_info.
ZSH_PROMPT_COLOR_BRANCHZSH_PROMPT_COLOR_REVISIONANSI color of ZSH_PROMPT_SYMBOL_BRANCH in vcs_info.
ZSH_PROMPT_SYMBOL>Main PS1/PROMPT symbol.
ZSH_PROMPT_SYMBOL_JOBS☰ Prefix ZSH_PROMPT_SYMBOL if any jobs running in the backround.
ZSH_PROMPT_SYMBOL_ERRORPrefix ZSH_PROMPT_SYMBOL if last command resulted in an error.
ZSH_PROMPT_SYMBOL_REVISIONPrefix ZSH_PROMPT_REVISION with commit symbol
ZSH_PROMPT_SYMBOL_BRANCHPrefix vcs_info with branch symbol.
ZSH_PROMPT_SYMBOL_UNTRACKED*Display if any untracked changes in vcs_info.
ZSH_PROMPT_SYMBOL_ADDED+Display if any added changes in vcs_info.
ZSH_PROMPT_SYMBOL_RENAMED~Display if any renamed changes in vcs_info.
ZSH_PROMPT_SYMBOL_MODIFIEDZSH_PROMPT_SYMBOL_ADDEDDisplay if any modified changes in vcs_info.
ZSH_PROMPT_SYMBOL_DELETED-Display if any deleted changes in vcs_info.
ZSH_PROMPT_SYMBOL_STASHEDZSH_PROMPT_SYMBOL_JOBSDisplay if any stashes in vcs_info.
ZSH_PROMPT_SYMBOL_FETCHPrefix remote vcs_info with fetch symbol, such as sync.
ZSH_PROMPT_SYMBOL_BEHIND↓Display if any commits behind the remote in vcs_info
ZSH_PROMPT_SYMBOL_AHEAD↑Display if any commits ahead of the remote in vcs_info.
ZSH_PROMPT_SYMBOL_FORMAT_PREFIXPrefix ZSH_PROMPT_FORMAT with symbol, such as [.
ZSH_PROMPT_SYMBOL_FORMAT_SUFFIXAppend ZSH_PROMPT_FORMAT with symbol, such as ].
ZSH_PROMPT_FORMAT%b%u%c%mFormat of vcs_info. See below table for reference.
ZSH_PROMPT_PWDfalseDisplay the Present Working Directory (PWD).
ZSH_PROMPT_COUNT_JOBSfalseDisplay number of jobs running in the background.
ZSH_PROMPT_REVISIONfalseDisplay latest commit revision hash in vcs_info.
ZSH_PROMPT_REMOTEfalseDisplay remote branch in vcs_info.
ZSH_PROMPT_COUNT_FETCHtrueDisplay number of commits ahead/behind the remote in vcs_info.
ZSH_PROMPT_COUNT_STASHEDfalseDisplay number of stashes in vcs_info.
ZSH_PROMPT_COUNT_CHANGEDfalsePrefix each change in vcs_info with number files changed.

vcs_info reference:

formatsinfo
%bbranch
%uunstaged
%cstaged
%mstashed
%7.7iRevision

License

MIT © Daniel Bayley