Enable the Git Plugin in Oh My Zsh to Show Branch and Dirty State in Prompt

Desired outcome

After enabling the Git plugin, your shell prompt will display the current branch name when you are inside a Git‑managed directory and will change visually (e.g., add an asterisk or change color) when the working tree has uncommitted changes.

Prerequisites

• Oh My Zsh installed and set as your default shell.
• The git executable present in your $PATH.
• Write permission to edit ~/.zshrc (your user’s home directory).

Procedure

1. Open the configuration file in a text editor (e.g., nano ~/.zshrc or vim ~/.zshrc).
2. Locate the line that defines the plugins array; it usually looks like plugins=(git) or plugins=(…).
3. Ensure the word git appears inside the parentheses. If it is missing, add it, separating it with spaces from other plugins, e.g., plugins=(git docker).
4. Save the file and exit the editor.
5. Reload the configuration without closing the terminal: run source ~/.zshrc. Alternatively, start a new terminal session.

Expected checks

1. Navigate to any directory that is a Git repository (cd /path/to/repo).
2. Observe the prompt: it should show the branch name in parentheses, e.g., (main).
3. Make a change (echo test > foo.txt) and save it.
4. The prompt should update to indicate a dirty state; the exact visual cue depends on your theme (many themes add an asterisk * or change the branch color).
5. Run git status to confirm the working tree is indeed dirty; the prompt should reflect the same state.

Recovery options

If the prompt behaves unexpectedly or you wish to disable the Git plugin:

1. Edit ~/.zshrc again.
2. Either remove git from the plugins array or comment out the entire line (# plugins=(git)).
3. Save the file and run source ~/.zshrc or open a new terminal.
4. The prompt will revert to its previous behavior.

Limitations and practical verification

The Git plugin only affects the prompt when Oh My Zsh’s theme uses the git_prompt_info function (most bundled themes do). If you have a custom PROMPT variable or a theme that does not call this function, the branch indicator may not appear. To verify that your theme supports it, run echo $ZSH_THEME and consult the theme’s source file in $ZSH/themes/ for a reference to git_prompt_info. If the function is missing, consider switching to a theme that includes it (e.g., agnoster, robbyrussell) or adding the function manually to your custom theme.