Check your usage limits and reset times.
Track Codex, Claude, Antigravity, Grok, Kimi, Devin and Meta Muse on your phone and in home-screen widgets.
Features · Widgets · Multiple accounts · App tour · Providers · Build · Documentation
Development preview. See Build to run the app from source.
| Accounts | Reset times | Home-screen widgets |
|---|---|---|
| Check usage across all your connected accounts. | See which limit resets next and when. | Check your usage without opening the app. |
Choose a compact summary, detailed usage bars or rings to keep your usage visible on the home screen.
Shows the five-hour and longer-term allowances, the next reset and the account's quota status in a compact row. The layout adjusts to the widget's width.
To track more than one account, add a widget for each and select the account in its settings.
Shows each account's provider, remaining allowances and reset times as a set of usage bars. Filter by provider or choose a custom set of accounts and arrange them in any order.
Shows a usage ring around each provider logo, with the account name and reset time beside it. Larger widgets can display multiple columns.
Compact rings with a provider logo for each account. Choose which accounts appear and their order in the widget settings.
iPhone and iPad widgets
| Widget | Availability | Layout and options |
|---|---|---|
| Usage Bars | iOS 17+ | Usage bars in small, medium and large sizes. Choose an account, a provider or a custom selection. |
| Account Rings | iOS 17+ | A grid of rings with account names and reset times. |
| Mini Rings | iOS 17+ | Compact rings with provider logos. |
| Usage Limits | iOS 16+ | Usage tiles in small, medium and large sizes; also available on the Lock Screen as a rectangular widget. |
| Usage Limits (Clear) | iOS 16+ | Usage tiles with a transparent background. |
| Usage Ring | iOS 16+ | A single-account ring; also a circular Lock Screen accessory. |
The iOS 16 widgets select accounts using the app's ranking. On iOS 17+, use Usage Bars, Account Rings or Mini Rings to choose an account, filter by provider or use a saved layout.
| Choose the content | Arrange the accounts | Set the appearance |
|---|---|---|
| Show all accounts, one provider, one account or a custom selection. | Use the app's account order or set your own. | Android: background colour, opacity and text colour. Configurable iOS widgets: transparent background and text colour. |
Widgets display locally cached usage. Refreshing a widget requests a sync on Android and opens the app on iOS. See Widgets for configuration and technical details.
Add multiple accounts from the same provider, such as personal and work subscriptions. Each account has its own usage limits and reset times.
Add each account in Accounts. In the widget settings, select One provider to group its accounts, One account to show a single account, or Custom to combine accounts from different providers. On iOS 17+, custom layouts can be saved in the app's settings.
Explore Overview, Accounts, Resets and Settings in the app tour, which also includes a widget gallery. The linked page explains how to open the tour in your browser.
| Provider | Usage windows | Connect with |
|---|---|---|
| OpenAI Codex | Five-hour, weekly, plan-dependent limits and reset credits | OAuth + PKCE; device-code fallback |
| Claude | Five-hour and reported weekly / per-model windows | OAuth + PKCE |
| Antigravity | Per-model quota buckets | Google OAuth + PKCE |
| Grok | Weekly credits and monthly billing window | Device-code flow |
| Kimi Code | Coding quota and reset windows | Device code or console key |
| Devin | Daily and weekly seat quota | OAuth + PKCE loopback |
| Meta Muse | Rolling subscription window and weekly quota | OAuth device code |
Android and iOS include integrations for all seven providers. Sign-in has not yet been verified for every provider, and Kimi OAuth usage access may require vendor approval.
Use Android SDK platform 36 and JDK 21 for the tests.
./gradlew :app:assembleDebug
./gradlew :app:testDebugUnitTestYou'll need macOS, Xcode and XcodeGen.
swift test --package-path ios/UsageLimitsKit
cd ios/UsageLimits && xcodegen generateOpen the generated project in Xcode to configure signing and run the app.
The app connects directly to each provider using your account. It reads usage limits without making model requests and has no backend, proxy or telemetry. Credentials are kept in Android Keystore-backed storage or iOS Keychain; widgets only access cached usage data.
Some integrations use undocumented provider APIs and may need updates when those APIs change. See the security model and release readiness for details.
| Start here | For contributors |
|---|---|
| Device compatibility | Architecture |
| Widgets | Verification |
| Security | Release guide |
Provider setup and limitations are covered in the Codex, Devin,
Meta Muse and other docs/providers-* guides. Report bugs in
Issues.