bira

March 7, 2026 · View on GitHub

A fork of bira's theme.

What does it show?

  • On the left:
    • username@hostname
    • Working directory.
    • Current git branch name, or commit short hash when in 'detached HEAD' state. Also an indicator when in a dirty working tree.
    • Python venv indicator.
    • # when root, $ otherwise.
  • On the right:
    • Status code when there was an error.

Advanced settings

The git indicators can be customized by changing the following git-info module context formats:

Context nameDescriptionDefault format
branchBranch name%b
commitCommit short hash%c
dirtyDirty state%F{red}%{%G●%}%F{yellow}

Use the following command to override a git-info context format:

zstyle ':zim:git-info:<context_name>' format '<new_format>'

For detailed information about these and other git-info settings, check the git-info documentation.

These advanced settings must be defined at the bottom of your ~/.zshrc, after the modules are initialized with source ${ZIM_HOME}/init.zsh, in order to override the theme defaults.

Requirements

Requires Zim Framework's git-info module to show git information.