README.md

gimbo's zsh prompt theme

A zsh theme with lots of features, little eye candy, and a magic context-sensitive extra line

This is my zsh prompt, a modification/extension of the purepower config for the powerlevel10k theme.

It's fairly minimal in terms of eye candy, focusing on showing the interesting data, with a smattering of colour (suitable for a dark background) to highlight important parts.

The main feature of note is probably the second line, which only appears in the presence of a python venv or git repo.

Structure

This is a two- or three-line prompt, depending on context. We have:

• First line:

  • History number
  • Time
  • Context (i.e. username/hostname)
  • Directory writable status
  • Directory - in full
  • Status of last command if it failed
  • pyenv in use if not standard

• Second line - only shown if either of the following are present:

  • Python virtualenv name
  • Git info, consisting of:
    • Repo name (i.e. name of folder containing .git folder)
    • (A fixed ± separator)
    • Branch name
    • Dirtiness indicators

• Actual prompt line:

  • Just a $ except if in vicmd mode (then it's a <)
  • Green if last command succeeded; red otherwise.

• Right hand side:

  • Command execution time
  • Indicator if user is root
  • Background jobs indicator

Screenshots

Same examples, With annotations: