https://github.com/zimfw/agnoster
A Zim Framework version of Agnoster, a Powerline-inspired theme for Zsh.
https://github.com/zimfw/agnoster
agnoster agnoster-theme powerline prompt theme zim zimfw zsh zsh-plugin zsh-plugins zsh-theme
Last synced: about 1 month ago
JSON representation
A Zim Framework version of Agnoster, a Powerline-inspired theme for Zsh.
- Host: GitHub
- URL: https://github.com/zimfw/agnoster
- Owner: zimfw
- License: mit
- Created: 2018-01-31T21:40:57.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-03-06T23:57:45.000Z (3 months ago)
- Last Synced: 2026-03-07T04:44:06.093Z (3 months ago)
- Topics: agnoster, agnoster-theme, powerline, prompt, theme, zim, zimfw, zsh, zsh-plugin, zsh-plugins, zsh-theme
- Language: Shell
- Homepage: https://zimfw.sh/docs/themes/
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
agnoster
========
A prompt theme based on the Powerline-inspired [original agnoster] theme and on
the deprecated [Powerlevel9k] theme.
What does it show?
------------------
* Status segment:
* Exit code when there was an error.
* `⚡` when you're root.
* `⚙` when there are background jobs.
* 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].
* `↑` and/or `↓` with respective count when there are commits ahead and/or
behind of remote.
* `⍟` with count when there are stashed states.
* `✚` when there are staged files.
* `●` when there are modified files.
* Git action, when there's an operation in progress.
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` |
| ahead | Commits ahead of remote count | ` ↑%A` |
| behind | Commits behind remote count | ` ↓%B` |
| stashed | Stashed states count | ` ⍟%S` |
| indexed | Indexed files | ` ✚` |
| unindexed | Unindexed files | ` ●` |
| action | Special action name | ` %s` |
| clean | Clean state | `green` |
| dirty | Dirty state | `yellow` |
Use the following command to override a git-info context format:
zstyle ':zim:git-info:' 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]. In addition, it looks better with the [Solarized theme].
Requires Zim Framework's [prompt-pwd] module to show the current working
directory, and [git-info] to show git information.
[original agnoster]: https://github.com/agnoster/agnoster-zsh-theme
[Powerlevel9k]: https://github.com/bhilburn/powerlevel9k
[venv]: https://docs.python.org/3/library/venv.html
['detached HEAD' state]: https://git-scm.com/docs/git-checkout#_detached_head
[prompt-pwd module settings]: https://github.com/zimfw/prompt-pwd/blob/master/README.md#settings
[git-info documentation]: https://github.com/zimfw/git-info/blob/master/README.md#settings
[instructions here]: https://github.com/powerline/fonts/blob/master/README.rst#installation
[Solarized theme]: https://github.com/altercation/solarized
[prompt-pwd]: https://github.com/zimfw/prompt-pwd
[git-info]: https://github.com/zimfw/git-info