eriner

A fork of the Powerline-inspired agnoster theme.

The aim of this theme is to only show you relevant information. Like most prompts, it will only show git information when in a git working directory. However, it goes a step further: everything from the current user and hostname to whether the last call exited with an error to whether background jobs are running in this shell will all be displayed automatically when appropriate.

What does it show?

• Status segment:
  • ✘ when there was an error.
  • ⚡ when you're root.
  • ⚙ when there are background jobs.
  • r when you're in a ranger spawned shell.
  • Python venv indicator.
  • username@hostname when in an SSH session.
• Working directory segment.
• Git segment (background color varies if working tree is clean or dirty):
  • Current branch name, or commit short hash when in 'detached HEAD' state.
  • Git action, when there's an operation in progress.
  • ± when in a dirty working tree.

Settings

The background color for each segment can be customized with an environment variable. If the variable is not defined, the respective default value is used.

Variable	Description	Default value
STATUS_COLOR	Status segment color	black
PWD_COLOR	Working directory segment color	cyan
CLEAN_COLOR	Clean git working tree segment color	green
DIRTY_COLOR	Dirty git working tree segment color	yellow

Advanced settings

You can customize how the current working directory is shown with the prompt-pwd module settings.

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

Context name	Description	Default format
branch	Branch name	 %b
commit	Commit short hash	➦ %c
action	Special action name	(%s)
dirty	Dirty state	±

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

In order for this theme to render correctly, a font with Powerline symbols is required. A simple way to install a font with Powerline symbols is to follow the instructions here.

Requires Zim Framework's prompt-pwd module to show the current working directory, and git-info to show git information.