https://github.com/tolluset/statusline
Enhanced statusline for Claude Code with Git status, GitHub notifications, and smart path display.
https://github.com/tolluset/statusline
claude-code statusline
Last synced: 2 months ago
JSON representation
Enhanced statusline for Claude Code with Git status, GitHub notifications, and smart path display.
- Host: GitHub
- URL: https://github.com/tolluset/statusline
- Owner: tolluset
- License: mit
- Created: 2025-08-19T20:27:13.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-19T21:03:23.000Z (10 months ago)
- Last Synced: 2026-03-31T06:35:45.793Z (3 months ago)
- Topics: claude-code, statusline
- Language: Go
- Homepage:
- Size: 40 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Code git Statusline
Enhanced statusline for [Claude Code](https://claude.ai/code) with Git status, GitHub notifications, and smart path display.
## Examples
**Format**: `[branch] [staged] [unstaged] [path]` (+ optional GitHub notifications)
```bash
~/project # Clean, no git repo
main ~/project # Clean, no changes
main ~1(1f+189-16) ~1(1f+242) ~/project # Detailed git stats
main ~1(1f+189-16) ~1(1f+242) 🔔3 ~/project # + GitHub notifications (optional)
```
## Installation
**Required**: Go 1.25+
1. **Place the file**
```bash
cp statusline.go ~/.claude/
```
2. **Configure Claude Code** (edit `~/.claude/settings.json`)
```json
{
"statusLine": {
"type": "command",
"command": "go run ~/.claude/statusline.go"
}
}
```
## GitHub Integration (Optional)
1. **Create token**: [GitHub Settings](https://github.com/settings/tokens) → Generate → Select `notifications`
2. **Create `~/.claude/.env` file**:
```bash
# ~/.claude/.env
GITHUB_TOKEN=ghp_your_token_here
SHOW_GITHUB_NOTIFICATIONS=true
```
## Format
| Symbol | Meaning |
| ---------- | --------------------------- |
| `+N` | N added files |
| `~N` | N modified files |
| `-N` | N deleted files |
| `(NfM+L-)` | N files, M+ lines, L- lines |
| `🔔N` | N GitHub notifications |
## Cache
GitHub API calls cached in `~/.statusline_cache` for 5 minutes:
```json
{
"timestamp": "2025-08-20T05:08:17+09:00",
"key": "github_notifications",
"content": "1"
}
```