/prompt

A minimal @z-shell prompt theme.

Primary LanguageShellMIT LicenseMIT


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 variable Default value Description
PS1/PROMPT ZSH_PROMPT_SYMBOL Default left aligned prompt.
RPS1/RPROMPT vcs_info Additional right aligned prompt.
ZLE_RPROMPT_INDENT 0 Number of spaces indentation to the right of RPS1/RPROMPT.
ZSH_PROMPT_NEWLINE true Add a newline after each command.
ZSH_PROMPT_SYMBOL_COLOR default ANSI color of ZSH_PROMPT_SYMBOL.
ZSH_PROMPT_COLOR_ERROR red ANSI color of ZSH_PROMPT_SYMBOL_ERROR.
ZSH_PROMPT_COLOR_COMMENT 8 ANSI bright black by default.
ZSH_PROMPT_COLOR_JOBS ZSH_PROMPT_COLOR_COMMENT ANSI color of ZSH_PROMPT_SYMBOL_JOBS.
ZSH_PROMPT_COLOR_PWD ZSH_PROMPT_COLOR_COMMENT ANSI color of ZSH_PROMPT_PWD.
ZSH_PROMPT_COLOR_ADDED green ANSI color of ZSH_PROMPT_SYMBOL_ADDED in vcs_info
ZSH_PROMPT_COLOR_UNTRACKED ZSH_PROMPT_COLOR_ADDED ANSI color of ZSH_PROMPT_SYMBOL_UNTRACKED in vcs_info.
ZSH_PROMPT_COLOR_MODIFIED yellow ANSI color of ZSH_PROMPT_SYMBOL_MODIFIED in vcs_info.
ZSH_PROMPT_COLOR_RENAMED blue ANSI color of ZSH_PROMPT_SYMBOL_RENAMED in vcs_info.
ZSH_PROMPT_COLOR_DELETED ZSH_PROMPT_COLOR_ERROR ANSI color of ZSH_PROMPT_SYMBOL_DELETED in vcs_info.
ZSH_PROMPT_COLOR_STASHED ZSH_PROMPT_COLOR_JOBS ANSI color of ZSH_PROMPT_SYMBOL_STASHED in vcs_info.
ZSH_PROMPT_COLOR_REVISION ZSH_PROMPT_COLOR_STASHED ANSI color of ZSH_PROMPT_SYMBOL_REVISION in vcs_info.
ZSH_PROMPT_COLOR_BRANCH ZSH_PROMPT_COLOR_REVISION ANSI 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_ERROR Prefix ZSH_PROMPT_SYMBOL if last command resulted in an error.
ZSH_PROMPT_SYMBOL_REVISION Prefix ZSH_PROMPT_REVISION with commit symbol
ZSH_PROMPT_SYMBOL_BRANCH Prefix 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_MODIFIED ZSH_PROMPT_SYMBOL_ADDED Display if any modified changes in vcs_info.
ZSH_PROMPT_SYMBOL_DELETED - Display if any deleted changes in vcs_info.
ZSH_PROMPT_SYMBOL_STASHED ZSH_PROMPT_SYMBOL_JOBS Display if any stashes in vcs_info.
ZSH_PROMPT_SYMBOL_FETCH Prefix 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_PREFIX Prefix ZSH_PROMPT_FORMAT with symbol, such as [.
ZSH_PROMPT_SYMBOL_FORMAT_SUFFIX Append ZSH_PROMPT_FORMAT with symbol, such as ].
ZSH_PROMPT_FORMAT %b%u%c%m Format of vcs_info. See below table for reference.
ZSH_PROMPT_PWD false Display the Present Working Directory (PWD).
ZSH_PROMPT_COUNT_JOBS false Display number of jobs running in the background.
ZSH_PROMPT_REVISION false Display latest commit revision hash in vcs_info.
ZSH_PROMPT_REMOTE false Display remote branch in vcs_info.
ZSH_PROMPT_COUNT_FETCH true Display number of commits ahead/behind the remote in vcs_info.
ZSH_PROMPT_COUNT_STASHED false Display number of stashes in vcs_info.
ZSH_PROMPT_COUNT_CHANGED false Prefix each change in vcs_info with number files changed.

vcs_info reference:

formats info
%b branch
%u unstaged
%c staged
%m stashed
%7.7i Revision

License

MIT © Daniel Bayley