zimfw / eriner

A Zim fork of the Powerline-inspired agnoster prompt theme.
MIT License
19 stars 14 forks source link
agnoster powerline prompt theme zim zimfw zsh zsh-plugin zsh-plugins zsh-prompt zsh-theme

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?

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 overridden after the theme is initialized.

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's prompt-pwd module to show the current working directory, and git-info to show git information.