Configuration

July 30, 2026 · View on GitHub

This is the default configuration. drop this in your .bashrc (or .zshrc) to get started. remember to source ~/.bashrc (or source ~/.zshrc) to observe the changes!

# prompt string to display, for regular users
export IAY_PROMPT_CHAR="$"
export IAY_PROMPT_CHAR_COLOR="green"

# prompt string to display, for the root user
export IAY_PROMPT_CHAR_ROOT="#"
export IAY_PROMPT_CHAR_ROOT_COLOR="red"

# if EXPAND_TILDE is set to 0, `/home/aaqa` is shortened to `~`
export IAY_EXPAND_TILDE=0

# if SHORTEN_CWD is set to 1, `/home/aaqa/work` is shortened to
# `/h/a/work`
export IAY_SHORTEN_CWD=1

# Set colour for the directory
# - When nested inside the user's home directory
# - When not nested inside the user's home directory
export IAY_CWD_HOME_COLOR="white"
export IAY_CWD_ROOT_COLOR="blue"

# Disable git information
export IAY_DISABLE_VCS=1

# The Nix-shell indicator is disabled by default. Set this to 1 to show it.
# Its default colour is grey (bright black).
export IAY_SHOW_NIX_SHELL=1
export IAY_NIX_SHELL_COLOR="bright black"

# there are three possible states for a git repo
# - unstaged (working tree has been modified)
# - staged (staging area has been modified)
# - clean (all staged changes have committed)

# colour to represent clean repo state
export IAY_GIT_CLEAN_COLOR="green"

# symbol to represent unstaged repo state
export IAY_GIT_STATUS_UNSTAGED="±"
export IAY_GIT_WT_MODIFIED="cyan"

# symbol to represent staged repo state
export IAY_GIT_STATUS_STAGED="±"
export IAY_GIT_INDEX_MODIFIED_COLOR="yellow"

# symbol and colour to represent a new file
export IAY_GIT_STATUS_NEW="!"
export IAY_GIT_WT_ADDED_COLOR="magenta"

# symbol to represent stashed changes indicator
export IAY_GIT_STATUS_STASH="$"

# Full working-tree traversal is enabled by default so untracked files are
# displayed. Set this to 0 for a faster prompt in very large repos.
export IAY_GIT_CHECK_UNTRACKED=0

# These are enabled by default to preserve the original prompt display. Set
# either to 0 to skip its Git graph/ref traversal for a faster prompt.
export IAY_GIT_SHOW_UPSTREAM=0
export IAY_GIT_SHOW_STASH=0

# Change branch colour when HEAD modifies
export IAY_GIT_BRANCH_MODIFIED_COLOR="blue"

# if HEAD ref peels to branch
export IAY_BRANCH_COLOR="green"

# if HEAD ref peels to a commit (detached state)
export IAY_COMMIT_COLOR="green"

All 16 colors are available:

black
red
green
yellow
blue
magenta (or purple)
cyan
white

bright black
bright red
bright green
bright yellow
bright blue
bright magenta (or purple)
bright cyan
bright white