A straight line says you'll hit your weekly Claude limit at 4 a.m. on a Friday

Description and use

Claude Code Tray shows real‑time usage in the system tray, turns red when the current pace will hit the weekly limit, and suggests a pause/resume time to stay under the cap.

Problem

Users of Claude Code on a subscription face a weekly usage cap that is hard to anticipate, leading to unexpected quota exhaustion during idle periods.

Outcome

The tray app provides an accurate, real‑time visual forecast of weekly quota usage, enabling users to avoid unexpected exhaustion and plan work accordingly.

Workflow

• 1. Install Claude Code Tray via winget or per‑user installer.
• 2. The app reads the OAuth token stored by Claude Code and polls the rate‑limit headers on each interval.
• 3. For the 5‑hour session, it keeps a short rolling history and fits a least‑squares slope to predict near‑term usage.
• 4. For the weekly cap, it compares current usage to an even‑pace line (elapsed ÷ 7 days) and turns the icon red if usage exceeds that line.
• 5. It projects the time to 100% using the rule of three: time to 100% = elapsed × (100 − used) ÷ used.
• 6. If sufficient history (>3 weeks) exists, it shapes the projection based on typical activity patterns; otherwise it uses the straight average‑pace line.
• 7. When the projection indicates early exhaustion, it suggests the earliest hour to pause and resume to finish the week under the limit.
• 8. The tray icon updates in real time, providing a visual cue without needing to open the app.

Evidence

Claude Code on a subscription has two limits: a 5‑hour session and a weekly cap.

Source

I built a small Windows tray app, Claude Code Tray, that draws the usage as the icon itself and turns it red when the current pace would reach 100% before the window resets.

Source

The app reads the OAuth token Claude Code already stores on your machine and makes a minimal API call on each poll, only to read the rate‑limit headers.

Source

If sufficient history (>3 weeks) exists, it shapes the projection based on typical activity patterns; otherwise it uses the straight average‑pace line.

Source