A native Android app that adds a home screen widget showing your Claude.ai usage limits at a glance — without opening any app.
Platform availability: Android only for now. iOS support is planned but not yet available as it requires an Apple Developer account.
Medium (4×2) — Progress Bars |
Small (2×2) — Circular Dials |
- Auto-refresh — Updates every 15 minutes in the background
- Color-coded — Green (low), orange (medium) usage indicators
- Reset timers — Shows exactly when your limits reset
- Tap to refresh — Manual refresh button on the widget
- Secure — Session cookie stored encrypted on-device, never leaves your phone
- Go to the Releases page and download the latest
app-release.apk - On your Android phone, open Settings → Apps → Special app access → Install unknown apps and allow your browser or file manager to install APKs
- Open the downloaded APK and tap Install
Note: Android may warn that the app is from an unknown source. This is expected for any APK installed outside the Play Store. The app is completely safe open source — you can review every line of code in this repo.
git clone https://github.com/StefanosKontopoulos/claude-widget.git
cd claude-widget/android
./gradlew assembleDebug # macOS / Linux
gradlew assembleDebug # WindowsInstall the APK from app/build/outputs/apk/debug/app-debug.apk
Open the app and tap Sign in to Claude. A login page will appear.
Important: When the cookie consent prompt appears, tap Allow (or Accept). The app uses your browser session cookie to read your usage data — this prompt is part of how that works. If you dismiss it, ! the login will not complete !
- Long-press on your home screen
- Tap Widgets
- Search for Claude Widget
- Long-press and drag it to your home screen
Your data never leaves your device:
- The session cookie is stored encrypted on-device using AES-256 encryption
- The app makes requests only to
claude.ai— no third-party servers, no analytics, no tracking - All connections to
claude.aiuse certificate pinning — the app rejects any certificate not issued by a known Let's Encrypt intermediate, blocking MITM interception even from device-trusted proxies - You can sign out at any time from the app, which wipes all stored credentials immediately
Widget not updating after login or logout?
Give it a few seconds — the widget re-renders automatically. If it still looks stuck, remove the widget from your home screen and add it again.
Found a bug?
Please open an issue on GitHub with a description of what happened and your Android version. This helps a lot.
- Android 8.0 (API 26) or higher
- A Claude.ai account
MIT License — see LICENSE