Claude Usage Widget

Android home screen widget that displays your Claude Pro/Max subscription usage limits.

Features

• Bar Widget: Horizontal/vertical progress bars showing 5-hour and 7-day usage
• Radial Widget: Circular rings display
• System accent or Claude orange color themes
• Auto-refreshes every 15 minutes

Requirements

• Android 8.0+
• Claude Code CLI installed and authenticated
• Java 17+ (or Android Studio)

Build

# Set JAVA_HOME if not using Android Studio's bundled JDK
export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"

# Build debug APK
./gradlew assembleDebug

APK output: app/build/outputs/apk/debug/app-debug.apk

Setup

1. Install the APK on your Android device

2. Get your OAuth token:

   macOS:

   security find-generic-password -s "Claude Code-credentials" -w

   Linux:

   cat ~/.config/claude-code/credentials.json

3. Copy the accessToken value from the JSON output

4. Open the app and paste the token

5. Add the widget to your home screen

Widgets

Widget	Description
Claude Usage - Bars	Progress bars, resizable horizontal/vertical
Claude Usage - Radial	Concentric rings