Initial release: Claude Pro usage widget for Android

README.md

@@ -0,0 +1,30 @@
+# 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](../../releases/latest)
+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