Quantum Theme for ZSH

June 3, 2026 · View on GitHub

Preview

A lightweight, configurable ZSH theme with git integration, built for oh-my-zsh.

Installation

One-liner:

bash <(curl -fsSL https://raw.githubusercontent.com/calebephrem/quantum-zsh/main/install.sh)

Manual:

Clone the repository

   git clone https://github.com/calebephrem/quantum-zsh ~/.oh-my-zsh/custom/themes/quantum

Copy the default config

   cp ~/.oh-my-zsh/custom/themes/quantum/.quantumrc ~/.quantumrc

Add the qtm alias to your .zshrc

   echo 'alias qtm="source ~/.oh-my-zsh/custom/themes/quantum/cli.sh"' >> ~/.zshrc

Set the theme in your .zshrc

   ZSH_THEME="quantum/quantum"

Reload your shell

   exec zsh

Configuration

Quantum is configured through ~/.quantumrc, created automatically on install script.

Using the CLI:

qtm set GIT_BRANCH_SYMBOL " "
qtm set DIR_STYLE short
qtm set GIT_SHOW_DIRTY false
qtm get COLOR_ARROW
qtm list
qtm reload
qtm reset # To restore quantum theme to it's initial config

Segments

Control what shows in your prompt by editing the SEGMENTS array in ~/.quantumrc:

SEGMENTS=(dir git_status)

Available segments: dir, git_status, venv, user, host, time, exit_code

Options

Key	Default	Description
`SEGMENTS`	`(dir git_status)`	Segments to display, in order
`PROMPT_SYMBOL`	`»`	Arrow/separator symbol
`GIT_BRANCH_SYMBOL`	``	Symbol before branch name
`GIT_DIRTY_SYMBOL`	`✗`	Shown when working tree is dirty
`GIT_CLEAN_SYMBOL`	``	Shown when working tree is clean
`GIT_AHEAD_SYMBOL`	`↑`	Shown when ahead of remote
`GIT_BEHIND_SYMBOL`	`↓`	Shown when behind remote
`COLOR_DIR`	`cyan`	Directory color
`COLOR_BRANCH`	`yellow`	Branch name color
`COLOR_DETACHED`	`red`	Detached HEAD color
`COLOR_ARROW`	`green`	Prompt symbol color
`COLOR_DIRTY`	`red`	Dirty indicator color
`COLOR_CLEAN`	`green`	Clean indicator color
`COLOR_VENV`	`blue`	Virtual environment color
`COLOR_USER`	`magenta`	Username color
`COLOR_HOST`	`white`	Hostname color
`COLOR_TIME`	`white`	Time color
`COLOR_EXIT_OK`	`green`	Exit code color on success
`COLOR_EXIT_FAIL`	`red`	Exit code color on failure
`DIR_STYLE`	`name`	`name`, `short`, or `full`
`GIT_SHOW_DIRTY`	`true`	Show dirty indicator
`GIT_SHOW_AHEAD_BEHIND`	`false`	Show ahead/behind counts
`SHOW_VENV`	`true`	Show Python virtual environment name
`SHOW_EXIT_CODE`	`false`	Show exit code of last command
`NEWLINE_BEFORE_PROMPT`	`false`	Print a newline before each prompt

Valid color values: black, red, green, yellow, blue, magenta, cyan, white

Screenshot

Notes

Found a bug? Open an issue
Using VS Code? Check out the Quantum VS Code theme
Enjoying the theme? Show some love by starring the repo. It helps more shell stylists discover Quantum Theme :3