5-Hour Blocks

What Are 5-Hour Blocks?

Claude Code's billing operates on 5-hour rolling windows. Each window tracks your token usage, and if you exceed the rate limit within a window, you're temporarily throttled.

Tools like ccusage track these blocks on a single machine. But if you're using Claude Code on multiple PCs, your combined usage across machines counts against the same window. claude-telemetry aggregates block data across all your machines.

Multi-PC Block Timeline

claude-telemetry provides a timeline view showing block windows across all your machines:

Machine A:  ████░░░░░░░░████████░░░░░░░░░░░░░░░░░░░░░
Machine B:  ░░░░░░████░░░░░░░░░░████████░░░░░░░░░░░░░░
Combined:   ████░░████░░████████████████░░░░░░░░░░░░░░░
            ─────────────────────────────────────────────
            12:00  13:00  14:00  15:00  16:00  17:00

This lets you see:

• Overlap periods — times when multiple machines are consuming tokens simultaneously
• Block utilization — how much of each 5-hour window you've used
• Remaining capacity — how many tokens you can still use before hitting the limit

Active Block Card

The dashboard shows an active block card with:

• Current block start/end times
• Token usage within the current block
• Burn rate (tokens/minute)
• Projected exhaustion time at current pace

Burn Rate Integration

Each block shows the current burn rate (tokens/minute) and a projection of when you'll hit the limit if you continue at the same pace. See Burn Rate for details.

Block History

Historical view of past blocks with:

• Peak usage periods
• Average block utilization
• Days you hit rate limits
• Patterns and trends

Implementation Notes

• Block data is calculated from session timestamps already stored in Supabase
• No changes to the agent are needed — the dashboard computes blocks from existing data
• Real-time updates via Supabase's real-time subscriptions