https://github.com/diegoos/cleanzsh
Clean ZSH theme
https://github.com/diegoos/cleanzsh
Last synced: about 2 months ago
JSON representation
Clean ZSH theme
- Host: GitHub
- URL: https://github.com/diegoos/cleanzsh
- Owner: diegoos
- License: mit
- Created: 2019-12-17T16:41:38.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-11-07T19:30:16.000Z (7 months ago)
- Last Synced: 2025-11-07T21:19:25.897Z (7 months ago)
- Language: Shell
- Size: 36.1 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-zsh-plugins - cleansh - Minimalist, includes `git`, Ruby, node and Python version status decorations. Works with standard fonts. (Themes / ZSH on Windows)
- fucking-awesome-zsh-plugins - cleansh - Minimalist, includes `git`, Ruby, node and Python version status decorations. Works with standard fonts. (Themes / ZSH on Windows)
README
# CleanSH ZSH Theme
CleanSH is a lightweight, performance-minded Zsh prompt theme that shows the current user,
working directory, Git branch and detected runtime versions (Ruby, Node, Python, PHP) with
compact icons and minimal overhead.
## Features
- Displays runtime versions detected from `mise`, `asdf`, `nvm`, `rvm` or `rbenv`.
- Per-directory caching to avoid repeated tool calls.
- Single-process parsing (reduces forks) for speed.
- Auto-refreshes when version managers change versions (via `preexec`).
- Small icons next to each version.
## Screenshot
## Install
Copy `cleanzsh.zsh-theme` into your Zsh themes directory (for example `~/.oh-my-zsh/custom/themes/`).
Then set the theme in your `~/.zshrc`:
```sh
ZSH_THEME="cleanzsh"
```
Reload the shell or source your `~/.zshrc`.
## Notes
- The theme tries to be non-invasive: it does not override existing tool functions and uses
`preexec`/`precmd` hooks to keep the prompt up-to-date.
- Some version managers expose shell functions (e.g. `nvm`); these are detected when available.
## License
See the repository [LICENSE](LICENSE) file.