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 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