Home

Awesome

Minimal, fast zsh themes

screenshot

Features

Git integration

The basics from left to right: branch (master), number of commits ahead (1↑), number of commits behind (1↓), indicators for untracked/modified/staged.

Screenshot showing basic git status

Detached head warning, non-head-branch (master~2), active merge/rebase indicator (⚡︎).

Screenshot showing git status during a merge

Bisecting:

Screenshot showing git status during bisection

Submodules or nested repos:

Screenshot showing git status inside a submodule

Installation

For zgen users

Add this to your ~/.zshrc with your other plugins, after loading oh-my-zsh:

  zgen load mafredri/zsh-async
  zgen load mje-nz/zsh-themes async
  # or to disable asynchronous mode
  zgen load mje-nz/zsh-themes simple

For antigen users (untested)

Add this to your ~/.zshrc somewhere after loading oh-my-zsh:

antigen bundle mafredri/zsh-async
antigen theme https://github.com/mje-nz/zsh-themes async

For zplug users (untested)

Add this to your ~/.zshrc with your other plugins:

zplug mafredri/zsh-async, from:github
setopt prompt_subst
zplug "mje-nz/zsh-themes", use:async.zsh-theme, defer:3

Configuration

See the top of src/prompt_common.zsh for configuration variables; to change them, export them in your .zshrc.