claude-usage-widget/README.md

Claude Usage Widget

Android home screen widget that shows your Claude Pro usage at a glance.

Features

• SESSION bar — current 5-hour window utilization with reset time
• WEEKLY bar — 7-day rolling usage with reset time
• Tap the widget to open the app; tap ⟳ to force-refresh
• Responsive: works as 4×1 (compact) or 4×2 (full)
• Auto-refreshes every 5 minutes in the background

Install

1. Download claude-usage-widget.apk from the latest release
2. On your Android phone: Settings → Apps → Install unknown apps → allow your browser/file manager
3. Open the downloaded APK and tap Install
4. Open the Claude Usage app and sign in with your Claude.ai session cookies
5. Long-press your home screen → Widgets → Claude Usage → drag to place

Sign-in

The app uses your Claude.ai browser cookies (not a password). In the app, tap Sign In, then paste your cookies from a logged-in Claude.ai browser session.

To get cookies: open claude.ai in Chrome → DevTools (F12) → Application → Cookies → copy the Cookie header value.

Requirements

• Android 8.0+ (API 26)
• Active Claude Pro subscription