Episode 8: Git Status & Tool Activity

⏱ Est. reading time: 4 min Updated on 5/7/2026

Key Takeaway: See in real-time what Claude is doing β€” which file it's editing, which Agent is running, how many Todos are done.


8.1 Git Status Display

[Opus] β”‚ my-project git:(main* !3 +1 ?2 ↑2 ↓1)
Symbol Meaning
* Has uncommitted changes
!3 3 modified files
+1 1 added/staged file
✘ Deleted files (omitted when 0)
?2 2 untracked files
↑2 2 commits ahead of remote
↓1 1 commit behind remote

8.2 Git Configuration

{
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": true,
    "pushWarningThreshold": 5,
    "pushCriticalThreshold": 10,
    "branchOverflow": "truncate"
  }
}
Config Description
showDirty Show * marker
showAheadBehind Show ↑N ↓N
showFileStats Show !M +A ✘D ?U
pushWarningThreshold Turns yellow when unpushed commits β‰₯N
pushCriticalThreshold Turns red when unpushed commits β‰₯N

8.3 Tool Activity Line

With showTools: true:

◐ Edit: auth.ts | βœ“ Read Γ—3 | βœ“ Grep Γ—2
Info Meaning
◐ Edit: auth.ts Currently editing auth.ts
βœ“ Read Γ—3 Completed 3 Read operations
βœ“ Grep Γ—2 Completed 2 Grep operations

8.4 Agent Status Line

With showAgents: true:

◐ explore [haiku]: Finding auth code (2m 15s)
Info Meaning
explore Agent name
[haiku] Model being used
Finding auth code Current task description
(2m 15s) Running duration

8.5 Todo Progress Line

With showTodos: true:

β–Έ Fix authentication bug (2/5)
Info Meaning
β–Έ Currently in-progress task
Fix authentication bug Task name
(2/5) 2 completed out of 5 total

Next Episode: Episode 9 explores HUD's advanced features β€” cache countdown, cost display, output speed, custom colors, and more.