calebephrem/quantum-zsh

Quantum is a nicely focused Zsh theme project: small enough to understand quickly, but more complete than a simple one-file prompt drop-in. The strongest part is that it treats customization as a first-class feature. The quantum.zsh-theme file supports configurable segments for directory, Git status, Python virtualenv, user, host, time, and exit code, and the defaults are easy to override through ~/.quantumrc. The Git prompt logic covers branch names, detached HEAD, dirty state, and optional ahead/behind counts, which is exactly the practical surface area most Oh My Zsh users expect without turning the theme into a heavyweight framework.

The repo also has good adoption work around the core theme. The README includes screenshots, one-line and manual install paths, a full options table, and examples for the qtm CLI. The installer is thoughtfully idempotent: it checks for Git, Zsh, and Oh My Zsh, avoids overwriting an existing ~/.quantumrc, and prompts before reinstalling. Including CONTRIBUTING.md, CHANGELOG.md, an MIT license, and recent commits from June 1, 2026 makes the project feel maintained rather than abandoned.

A few refinements would make it easier to trust in daily shell use. The README’s bash <(curl ...) install path is convenient, but security-conscious users would benefit from a short manual verification note or a pinned release asset once releases exist. The project currently has no published releases, so .quantumver and the changelog are useful locally but not yet tied to GitHub versioning. I’d also tighten a couple of doc mismatches: CONTRIBUTING.md references an _qtm_all_keys list that does not appear in the current cli.sh, and the CLI help says changelog shows the latest five entries while the recent commit says it now displays only the latest one. Overall, this is a polished and practical theme with a clear identity, especially for users who want a fast, Git-aware prompt without adopting a large prompt framework.