feat: show 5h usage window remaining in statusline

Parse rate_limits.five_hour from Claude Code's statusline input to
display remaining capacity as a battery indicator: 🔋 94% (1.5/5h).
Emoji switches to 🪫 below 25%. Auto-hidden for API billing users
(field absent). Add --no-5h flag to opt out.

Author: backstabslash

CLAUDE.md

@@ -104,6 +104,7 @@ One API call produces multiple JSONL entries sharing the same `requestId`. `inpu
 - **MCP sources** — six detection paths: `mcpServers` in settings.json, marketplace `enabledPlugins` with `.mcp.json` walk, project-level `.mcp.json` via `cwd` from transcript, `settings.local.json` in project `.claude/`, top-level `mcpServers` in `~/.claude.json`, and per-project `mcpServers` in `~/.claude.json`
 - **Config file** — `~/.goccc.json` stores currency code, cached rate, timestamp, and cost thresholds (`warn_threshold`/`alert_threshold`). `initConfig()` loads everything once: thresholds first (with swap-correction if misordered), then currency. Exchange rates auto-fetched and cached for 24h. `-currency-symbol` and `-currency-rate` flags override config (both required together). JSON output cost fields always in USD
 - **Session end hook** — `-session-end` reads `SessionEnd` JSON from stdin, parses the session transcript, and outputs a one-line cost summary. Uses `os.Exit(2)` + ANSI escape to overwrite Claude Code's "hook failed" prefix. Silently exits on any error — never breaks session teardown
+- **5h usage window** — statusline parses `rate_limits.five_hour` from Claude Code's stdin JSON (`used_percentage` + `resets_at` unix timestamp). Displayed as remaining percentage with elapsed time: `🔋 94% (1.5/5h)`. Uses pointer field (`*struct`) — nil when absent (API billing users), so the segment is auto-hidden. Emoji switches to 🪫 at ≤25% remaining. Color thresholds are inverted vs cost (yellow ≤50%, red ≤25% remaining). `-no-5h` flag opts out
 
 ## Don't
 

README.md

@@ -6,7 +6,7 @@
 
 A fast, zero-dependency CLI cost calculator and [statusline provider](#claude-code-statusline) for [Claude Code](https://code.claude.com/docs/en/overview) — single binary, no runtime needed.
 
-Parses JSONL logs from `~/.claude/projects/`, deduplicates streaming responses, and breaks down spending by model, day, project, and month — with accurate per-model pricing including cache write tiers, long-context premiums, and web search costs.
+Parses JSONL conversation logs and subagent sessions from `~/.claude/projects/`, deduplicates streaming responses, and breaks down spending by model, day, project, and branch — with accurate cache-tier and web search pricing.
 
 ![demo](https://github.com/user-attachments/assets/a65fc389-951d-47bc-9a69-5f498f3c1d32)
 
@@ -89,16 +89,17 @@ JSON output always reports costs in USD for backward compatibility, with a `curr
 goccc can serve as a [Claude Code statusline](https://code.claude.com/docs/en/statusline) provider — a live cost dashboard right in your terminal prompt.
 
 ```text
-💸 $1.23 session · 💰 $5.67 today · 💭 45% ctx · 🔌 2 MCPs (confluence, jira) · 🤖 Opus 4.6
+💸 $1.23 session · 💰 $5.67 today · 💭 45% ctx · 🔌 2 MCPs (confluence, jira) · 🔋 94% (1.5/5h) · 🤖 Opus 4.6
 ```
 
 - **💸 Session cost** — parsed from the current session's JSONL files using goccc's pricing table
 - **💰 Today's total** — aggregated across all sessions today (shown only when higher than session cost)
 - **💭 Context %** — context window usage percentage
 - **🔌 MCPs** — active MCP servers (from settings, marketplace plugins, and project config; respects per-project disables)
+- **🔋 5h window** — remaining percentage of the 5-hour usage window with elapsed time (subscription users only; hidden for API billing). Emoji switches to 🪫 below 25%
 - **🤖 Model** — current model
 
-Cost and context values are color-coded yellow → red as they increase.
+Cost and context values are color-coded yellow → red as they increase. The 5h window is color-coded in reverse — yellow below 50%, red below 25%.
 
 ### Setup
 
@@ -126,7 +127,7 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
-To hide the MCP indicator, add `-no-mcp`.
+To hide the MCP indicator, add `-no-mcp`. To hide the 5-hour usage window, add `-no-5h`.
 
 ## Session Exit Hook
 
@@ -191,6 +192,7 @@ Thresholds are in USD (before currency conversion). They apply to the terminal o
 | `-session-end` | | `false` | Session exit hook mode (reads SessionEnd JSON from stdin) |
 | `-statusline` | | `false` | Statusline mode for Claude Code (reads session JSON from stdin) |
 | `-no-mcp` | | `false` | Hide MCP servers from statusline output |
+| `-no-5h` | | `false` | Hide 5-hour usage window from statusline output |
 | `-currency-symbol` | | | Override currency symbol (requires `-currency-rate`) |
 | `-currency-rate` | | `0` | Override exchange rate from USD (requires `-currency-symbol`) |
 | `-version` | `-V` | | Print version and exit |

main.go

@@ -56,6 +56,7 @@ func main() {
 	statusline := flag.Bool("statusline", false, "Statusline mode: read session JSON from stdin, output formatted cost line")
 	sessionEnd := flag.Bool("session-end", false, "Session end hook mode: read SessionEnd JSON from stdin, print cost summary")
 	noMCP := flag.Bool("no-mcp", false, "Hide MCP servers from statusline output")
+	no5h := flag.Bool("no-5h", false, "Hide 5-hour usage window from statusline output")
 	currencySymbolFlag := flag.String("currency-symbol", "", "Override currency symbol (requires -currency-rate)")
 	currencyRateFlag := flag.Float64("currency-rate", 0, "Override exchange rate from USD (requires -currency-symbol)")
 
@@ -100,7 +101,7 @@ func main() {
 	initPricing()
 
 	if *statusline {
-		runStatusline(*baseDir, *noMCP)
+		runStatusline(*baseDir, *noMCP, *no5h)
 		return
 	}
 

pricing.go

@@ -11,13 +11,13 @@ import (
 )
 
 type ModelPricing struct {
-	Input           float64 `json:"input"`
-	Output          float64 `json:"output"`
-	CacheRead       float64 `json:"cache_read,omitempty"`
-	CacheWrite5m    float64 `json:"cache_write_5m,omitempty"`
-	CacheWrite1h    float64 `json:"cache_write_1h,omitempty"`
-	LongCtxInput    float64 `json:"long_ctx_input,omitempty"`
-	LongCtxOutput   float64 `json:"long_ctx_output,omitempty"`
+	Input               float64 `json:"input"`
+	Output              float64 `json:"output"`
+	CacheRead           float64 `json:"cache_read,omitempty"`
+	CacheWrite5m        float64 `json:"cache_write_5m,omitempty"`
+	CacheWrite1h        float64 `json:"cache_write_1h,omitempty"`
+	LongCtxInput        float64 `json:"long_ctx_input,omitempty"`
+	LongCtxOutput       float64 `json:"long_ctx_output,omitempty"`
 	LongCtxCacheRead    float64 `json:"long_ctx_cache_read,omitempty"`
 	LongCtxCacheWrite5m float64 `json:"long_ctx_cache_write_5m,omitempty"`
 	LongCtxCacheWrite1h float64 `json:"long_ctx_cache_write_1h,omitempty"`
@@ -46,11 +46,11 @@ type PricingDisplayName struct {
 }
 
 var (
-	pricingTable          map[string]ModelPricing
-	familyPrefixes        []PricingFamily
-	defaultPricing        ModelPricing
-	displayNames          []PricingDisplayName
-	longCtxThreshold      = 200_000
+	pricingTable           map[string]ModelPricing
+	familyPrefixes         []PricingFamily
+	defaultPricing         ModelPricing
+	displayNames           []PricingDisplayName
+	longCtxThreshold       = 200_000
 	webSearchCostPerSearch = 0.01
 )
 

statusline.go

@@ -14,6 +14,11 @@ import (
 const (
 	ctxThresholdRed    = 70.0
 	ctxThresholdYellow = 50.0
+
+	fiveHourWindow          = 5 * time.Hour
+	fiveHourThresholdRed    = 25.0
+	fiveHourThresholdYellow = 50.0
+	fiveHourLowBattery      = 25.0
 )
 
 type StatuslineInput struct {
@@ -27,9 +32,55 @@ type StatuslineInput struct {
 	ContextWindow struct {
 		UsedPercentage float64 `json:"used_percentage"`
 	} `json:"context_window"`
+	RateLimits struct {
+		FiveHour *struct {
+			UsedPercentage float64 `json:"used_percentage"`
+			ResetsAt       int64   `json:"resets_at"`
+		} `json:"five_hour"`
+	} `json:"rate_limits"`
 	TranscriptPath string `json:"transcript_path"`
 }
 
+func formatFiveHourUsage(usedPct float64, resetsAt int64, now time.Time) string {
+	remainPct := 100 - usedPct
+	if remainPct < 0 {
+		remainPct = 0
+	}
+
+	resetTime := time.Unix(resetsAt, 0)
+	remaining := resetTime.Sub(now)
+	if remaining < 0 {
+		remaining = 0
+	}
+	elapsed := fiveHourWindow - remaining
+	if elapsed > fiveHourWindow {
+		elapsed = fiveHourWindow
+	}
+
+	hours := elapsed.Hours()
+	var elapsedStr string
+	if hours == float64(int(hours)) {
+		elapsedStr = fmt.Sprintf("%d/5h", int(hours))
+	} else {
+		elapsedStr = fmt.Sprintf("%.1f/5h", hours)
+	}
+
+	emoji := "🔋"
+	if remainPct <= fiveHourLowBattery {
+		emoji = "🪫"
+	}
+
+	pctStr := fmt.Sprintf("%.0f%%", remainPct)
+	switch {
+	case remainPct <= fiveHourThresholdRed:
+		pctStr = redString(pctStr)
+	case remainPct <= fiveHourThresholdYellow:
+		pctStr = yellowString(pctStr)
+	}
+
+	return fmt.Sprintf("%s %s (%s)", emoji, pctStr, elapsedStr)
+}
+
 func readStatuslineInput(r io.Reader) (*StatuslineInput, error) {
 	var input StatuslineInput
 	if err := json.NewDecoder(r).Decode(&input); err != nil {
@@ -114,12 +165,19 @@ func formatStatusline(sCost, tCost float64, input *StatuslineInput, mcpNames []s
 		}
 		parts = append(parts, fmt.Sprintf("🔌 %d %s (%s)", len(mcpNames), label, list))
 	}
+	if input.RateLimits.FiveHour != nil {
+		parts = append(parts, formatFiveHourUsage(
+			input.RateLimits.FiveHour.UsedPercentage,
+			input.RateLimits.FiveHour.ResetsAt,
+			time.Now(),
+		))
+	}
 	parts = append(parts, "🤖 "+modelStr)
 
 	return strings.Join(parts, " · ")
 }
 
-func runStatusline(baseDir string, noMCP bool) {
+func runStatusline(baseDir string, noMCP, no5h bool) {
 	input, err := readStatuslineInput(os.Stdin)
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "goccc: %v\n", err)
@@ -144,6 +202,10 @@ func runStatusline(baseDir string, noMCP bool) {
 		tCost = todayData.Totals().Cost
 	}
 
+	if no5h {
+		input.RateLimits.FiveHour = nil
+	}
+
 	var mcpNames []string
 	if !noMCP {
 		mcpNames = detectMCPs(baseDir, input.TranscriptPath)

statusline_test.go

@@ -14,6 +14,7 @@ func TestReadStatuslineInput_Valid(t *testing.T) {
 		"model": {"id": "claude-opus-4-6", "display_name": "Opus"},
 		"cost": {"total_cost_usd": 1.23},
 		"context_window": {"used_percentage": 45.2},
+		"rate_limits": {"five_hour": {"used_percentage": 42, "resets_at": 1774468800}},
 		"transcript_path": "/home/user/.claude/projects/my-project/abc123.jsonl",
 		"session_id": "abc123"
 	}`
@@ -33,6 +34,15 @@ func TestReadStatuslineInput_Valid(t *testing.T) {
 	if input.TranscriptPath != "/home/user/.claude/projects/my-project/abc123.jsonl" {
 		t.Errorf("TranscriptPath = %q", input.TranscriptPath)
 	}
+	if input.RateLimits.FiveHour == nil {
+		t.Fatal("expected non-nil FiveHour")
+	}
+	if input.RateLimits.FiveHour.UsedPercentage != 42 {
+		t.Errorf("FiveHour.UsedPercentage = %f, want 42", input.RateLimits.FiveHour.UsedPercentage)
+	}
+	if input.RateLimits.FiveHour.ResetsAt != 1774468800 {
+		t.Errorf("FiveHour.ResetsAt = %d, want 1774468800", input.RateLimits.FiveHour.ResetsAt)
+	}
 }
 
 func TestReadStatuslineInput_InvalidJSON(t *testing.T) {
@@ -57,6 +67,81 @@ func TestReadStatuslineInput_MissingFields(t *testing.T) {
 	if input.TranscriptPath != "" {
 		t.Errorf("expected empty TranscriptPath, got %q", input.TranscriptPath)
 	}
+	if input.RateLimits.FiveHour != nil {
+		t.Errorf("expected nil FiveHour, got %+v", input.RateLimits.FiveHour)
+	}
+}
+
+func TestFormatFiveHourUsage(t *testing.T) {
+	noColorFlag = true
+	defer func() { noColorFlag = false }()
+
+	tests := []struct {
+		name     string
+		pct      float64
+		resetsAt int64
+		now      time.Time
+		want     string
+	}{
+		{
+			name:     "mid window low usage",
+			pct:      6,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 11, 30, 0, 0, time.UTC),
+			want:     "🔋 94% (1.5/5h)",
+		},
+		{
+			name:     "full hour no decimal",
+			pct:      20,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 12, 0, 0, 0, time.UTC),
+			want:     "🔋 80% (2/5h)",
+		},
+		{
+			name:     "just started full battery",
+			pct:      0,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 10, 0, 0, 0, time.UTC),
+			want:     "🔋 100% (0/5h)",
+		},
+		{
+			name:     "heavy usage low remaining",
+			pct:      85,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 14, 42, 0, 0, time.UTC),
+			want:     "🪫 15% (4.7/5h)",
+		},
+		{
+			name:     "fully depleted clamps to 0%",
+			pct:      100,
+			resetsAt: time.Date(2026, 3, 25, 10, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 11, 0, 0, 0, time.UTC),
+			want:     "🪫 0% (5/5h)",
+		},
+		{
+			name:     "at 25% remaining switches to low battery",
+			pct:      75,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 13, 0, 0, 0, time.UTC),
+			want:     "🪫 25% (3/5h)",
+		},
+		{
+			name:     "at 26% remaining stays full battery",
+			pct:      74,
+			resetsAt: time.Date(2026, 3, 25, 15, 0, 0, 0, time.UTC).Unix(),
+			now:      time.Date(2026, 3, 25, 13, 0, 0, 0, time.UTC),
+			want:     "🔋 26% (3/5h)",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			got := formatFiveHourUsage(tt.pct, tt.resetsAt, tt.now)
+			if got != tt.want {
+				t.Errorf("got %q, want %q", got, tt.want)
+			}
+		})
+	}
 }
 
 func TestParseSession_MainOnly(t *testing.T) {
@@ -231,6 +316,45 @@ func TestFormatStatusline(t *testing.T) {
 	}
 }
 
+func TestFormatStatusline_With5h(t *testing.T) {
+	noColorFlag = true
+	defer func() { noColorFlag = false }()
+
+	input := &StatuslineInput{}
+	input.Model.ID = "claude-opus-4-6"
+	input.ContextWindow.UsedPercentage = 34.0
+	input.RateLimits.FiveHour = &struct {
+		UsedPercentage float64 `json:"used_percentage"`
+		ResetsAt       int64   `json:"resets_at"`
+	}{UsedPercentage: 6, ResetsAt: time.Now().Add(2 * time.Hour).Unix()}
+
+	result := formatStatusline(1.35, 1.98, input, nil)
+	if !strings.Contains(result, "🔋 94%") {
+		t.Errorf("output %q missing 5h battery segment", result)
+	}
+	// 5h segment should appear before model
+	batteryIdx := strings.Index(result, "🔋")
+	modelIdx := strings.Index(result, "🤖")
+	if batteryIdx >= modelIdx {
+		t.Errorf("5h segment should appear before model: %q", result)
+	}
+}
+
+func TestFormatStatusline_No5h(t *testing.T) {
+	noColorFlag = true
+	defer func() { noColorFlag = false }()
+
+	input := &StatuslineInput{}
+	input.Model.ID = "claude-opus-4-6"
+	input.ContextWindow.UsedPercentage = 45.0
+	// RateLimits.FiveHour is nil (API billing)
+
+	result := formatStatusline(0.50, 2.00, input, nil)
+	if strings.Contains(result, "🔋") || strings.Contains(result, "🪫") {
+		t.Errorf("output %q should not contain battery when FiveHour is nil", result)
+	}
+}
+
 func TestFormatStatusline_WithMCPs(t *testing.T) {
 	noColorFlag = true
 	defer func() { noColorFlag = false }()