bigdave / hematite

A minimal zsh theme

Hematite

Hematite is a theme for Zsh. It is based upon the following tenets:

1. Information should only be displayed if it is useful - This is at my discretion, but each piece of information is explained as to why it is useful, and only displayed when it is relevant.
2. It should be easy to visually search the terminal history - This is accomplished via discrete and intentional styling, explained as part of this document.
3. The theme should not have a noticeable impact on performance - The run-time performance of the theme is analyzed as part of this document.

Elements of the Theme

Element	Why Show It?	Style	Performance
username	Know which user I am, for when I'm a dude playing a dude pretending to be another dude. So I don't do something crazy.	less prominent	O(1)
current directory	I need to know where I am, and where I was.	prominent	O(1)
exit status	I want an obvious indicator if something fails.	Red, the color of errors.	O(1)
git info	If I'm on a branch I want to know it.	less prominent	O(n)

Installation

oh my zsh

git clone --depth=1 https://github.com/bigdave/hematite.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/hematite

hematite's Issues

Please add a license file and a screen shot

I'd like to add this to awesome-zsh-plugins, but I prefer to add themes with screen shots in the readme so that users can see what they look like without having to install them.

Also, please add a license file, some people won't use any code that doesn't have an open source license. If you don't have one in mind, https://choosealicense.com is a good resource to help you select an appropriate one.

Thanks!