statusline

Git status line tool for Claude Code.

Example Output

statusline on ⎇ main ↑2 ↓1

• ⎇ icon color indicates repository status: green (clean), yellow (tracked changes), red (untracked files)
• ↑2 ahead of upstream, ↓1 behind upstream

Environment Variables

• STATUSLINE_NO_COLOR=1 — disable colors
• STATUSLINE_FETCH=1 — fetch upstream (slower, but accurate ↑/↓)
• STATUSLINE_FETCH_INTERVAL=30 — fetch interval in minutes (default: 30)

Claude Code Integration

Add to your settings.json:

macOS/Linux:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/bin/statusline",
    "padding": 0
  },
  "env": {
    "STATUSLINE_FETCH": "1",
    "STATUSLINE_FETCH_INTERVAL": "5"
  }
}

Windows (PowerShell):

{
  "statusLine": {
    "type": "command",
    "command": "%USERPROFILE%\\.claude\\statusline.exe",
    "padding": 0
  },
  "env": {
    "STATUSLINE_FETCH": "1",
    "STATUSLINE_FETCH_INTERVAL": "5"
  }
}

Windows (Git Bash/MinGW):

{
  "statusLine": {
    "type": "command",
    "command": "$HOME/.claude/statusline.exe",
    "padding": 0
  },
  "env": {
    "STATUSLINE_FETCH": "1",
    "STATUSLINE_FETCH_INTERVAL": "5"
  }
}

Cross-platform Builds

make xwin    # Windows
make xlinux  # Linux  
make xmac    # macOS

Requirements

• git in PATH

License

MIT