Skip to main content
Claude HUD shows git status on line 1 next to your project path. You can control how much detail is displayed. All git settings live under the gitStatus key in ~/.claude/plugins/claude-hud/config.json.

​
Options

​
gitStatus.enabled
boolean
default:"true"
Show the git branch indicator. Set to false to hide all git information.
​
gitStatus.showDirty
boolean
default:"true"
Append * to the branch name when there are uncommitted changes.
git:(main*)   ← dirty
git:(main)    ← clean
​
gitStatus.showAheadBehind
boolean
default:"false"
Show how many commits your local branch is ahead of or behind the remote.
git:(main ↑2 ↓1)
Counts of 0 are omitted, so a branch that is only ahead shows ↑2 without a ↓ indicator.
​
gitStatus.showFileStats
boolean
default:"false"
Show per-file-status counts alongside the branch name. Compatible with Starship’s git stats format.
git:(main* !3 +1 ?2)
  • ! = modified files
  • + = added / staged files
  • ✘ = deleted files
  • ? = untracked files
Counts of 0 are omitted for a cleaner display.

​
Display styles

Shows only the branch name. Enable by setting showDirty, showAheadBehind, and showFileStats all to false.
[Opus | Max] │ my-project git:(main)

{
  "gitStatus": {
    "enabled": true,
    "showDirty": false,
    "showAheadBehind": false,
    "showFileStats": false
  }
}

​
Changing git style interactively

Run /claude-hud:configure and proceed to the Git Style step. The options map directly to the styles above:
Interactive optionConfig equivalent
Branch onlyshowDirty: false, showAheadBehind: false, showFileStats: false
Branch + dirtyshowDirty: true, showAheadBehind: false, showFileStats: false
Full detailsshowDirty: true, showAheadBehind: true, showFileStats: false
File statsshowDirty: true, showAheadBehind: false, showFileStats: true

​
Troubleshooting

Git status not showing?
  • Verify you are inside a git repository
  • Check that gitStatus.enabled is not set to false in your config

Build docs developers (and LLMs) love

Get started for freeTalk to us