Question 1

How do I install git-prompt.zsh with Zinit?

Accepted Answer

Add 'zinit ice src"examples/multiline.zsh"' and 'zinit load woefe/git-prompt.zsh' to your .zshrc, as shown in the README's Zinit section. Omit the ice line for the default configuration, and ensure you source the file correctly.

Question 2

git-prompt.zsh vs powerlevel10k: which is better for Zsh?

Accepted Answer

git-prompt.zsh is a lightweight, customizable Git prompt focused on pure-shell implementation, while powerlevel10k is a complete, fast prompt theme with more out-of-the-box features. Choose git-prompt.zsh for granular control over Git status; opt for powerlevel10k if you want a full prompt system with minimal setup.

Question 3

How to change the symbols for staged files in git-prompt.zsh?

Accepted Answer

Set the ZSH_THEME_GIT_PROMPT_STAGED variable in your .zshrc to a custom symbol, like 'ZSH_THEME_GIT_PROMPT_STAGED="%{$fg[green]%}★"'. Refer to the Appearance section in the README for more variables and examples to tweak symbols and colors.

Question 4

Why does my git prompt not update after a git commit in another terminal?

Accepted Answer

git-prompt.zsh uses asynchronous updates and has no caching, so external changes might not show immediately. Press Enter to redraw the prompt, or enable ZSH_GIT_PROMPT_FORCE_BLANK to blank out outdated status, though this can increase flickering, as noted in the Force blank section.

Question 5

Can I use git-prompt.zsh on systems without awk?

Accepted Answer

No, awk is a required dependency for parsing Git output, and the README states it's essential for the pure-shell implementation. Most *nix systems have awk preinstalled, but if missing, you'll need to install it separately for the prompt to function.

Question 6

How to disable async updates in git-prompt.zsh for real-time status?

Accepted Answer

Set ZSH_GIT_PROMPT_NO_ASYNC=1 in your .zshrc before sourcing the file, but be warned this can make your shell slow in large repositories or with slow disks, as highlighted in the Disable async section of the README.

git-prompt (woefe)

What is git-prompt (woefe)?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions