Support
A little help,
when you need it.
Pairing, widgets, reset tracking, and the move to a free app. Find an answer below, or send us a note.
Pairing and accounts
Adding an account, scanning a replacement QR code, or using Usage Companion for Mac.
Setup helpVersion 1.1 and billing
What becomes free, which version is available, and how to manage an existing Apple subscription.
Access and billingWidgets and refreshes
Home and Lock Screen widgets, automatic refresh, and what to check when a number looks out of date.
Widget helpSample account
Try the account and refresh flow with public sample data, without connecting a provider account.
Open demoBanked resets
Provider-issued extra resets, available counts, and expiration times in version 1.1.
Reset trackingNeed a hand?
Send a note to support and include your app version, iOS version, device model, provider, and a short description of what happened. We will never ask you to email a credential, API key, QR code, or full screenshot containing one.
Accounts and pairing
Getting connected
How do I add or replace an account?
To add an account, open the top-left menu and choose Add an account. In version 1.1, you can also start from Getting started. Scan a pairing code or choose a supported provider under Or set one up by hand. To update an existing account, open its account menu and choose Replace. Replacing a credential keeps the account name and layout intact.
Why does Usage Companion show more than one QR code?
Some pairing payloads are too large for one QR code that a phone can scan reliably. Usage Companion breaks them into numbered, temporary codes. Scan every part; the phone accepts them in any order and assembles the pairing only when all parts are present.
What should I do if a QR code expires?
Return to Usage Companion and create a new pairing session. Pairing codes expire intentionally. Expiration keeps a code that was left on screen from remaining useful later.
Why is my Claude Code account paired through the Mac companion?
Claude Code uses desktop-held credentials for its usage access. Usage Companion verifies the account and transfers a separate, temporary pairing payload to your phone. It does not give the phone access to your Mac Keychain.
Can I use more than one account from the same provider?
Yes. Give each account a clear name when you add it. Usage Overview keeps their usage data and credentials separate so personal, work, and client accounts do not overwrite one another.
Version 1.1 and existing billing
Moving to a free app
Version 1.1 is not yet available. The App Store currently offers version 1.0. Removing the app’s subscription requirement does not automatically cancel an existing Apple subscription. Check its status in Settings → your name → Subscriptions.
What is free in version 1.1?
All app features, including live refreshes, Home Screen and Lock Screen widgets, reset details, and reset alerts, are free in version 1.1. That version has no purchase, trial, or Restore Purchases flow. Your existing connected accounts and settings stay in place when you update.
Your AI provider’s own account requirements, charges, and usage limits still apply. Usage Companion for macOS is already free.
Why does my app still ask for a subscription?
The currently available version 1.0 requires an active subscription or eligible trial for live refreshes, widgets, and reset alerts. The free update is version 1.1 and has not yet been released. Accounts remain on your device when version 1.0 access expires, but refreshes and related features pause.
How do I cancel an existing subscription or trial?
On your iPhone or iPad, open Settings, tap your name, then Subscriptions. Select Usage Overview and choose Cancel Subscription if available. Use the Apple Account that made the purchase. If Apple shows an expiration date and no Cancel button, the subscription is already cancelled. Apple’s cancellation instructions.
Updating or deleting the app does not cancel a subscription. Existing monthly subscriptions renew under Apple’s purchase terms until cancelled or discontinued through Apple. If you started a free trial, cancel at least 24 hours before it ends to avoid renewal.
Can I restore an existing purchase in version 1.0?
Yes. In version 1.0, open the subscription screen and choose Restore Purchases using the Apple Account that made the purchase. An active entitlement restores access. Version 1.1 removes this requirement; there is nothing to restore for feature access in that version.
What if I have a billing or refund question?
Apple handles subscription billing and refund decisions. The free update does not automatically issue a refund. See how to request a refund from Apple, or contact us for help understanding the app’s transition.
Reset tracking in version 1.1
Know what is available—and when it expires
Banked resets are extra usage resets issued by your AI provider. Usage Overview tracks them; it does not sell or redeem them. Availability depends on the provider and your account.
What do the reset counts mean?
The badges show the number of available resets reported by the provider. Where supported, full usage resets and five-hour resets appear separately. These are provider-issued allowances, not purchases from Usage Overview. To use a reset, follow your provider’s own controls and terms.
How do I see when a banked reset expires?
In version 1.1, tap a reset badge to open its details. Resets with known expiration dates are ordered by earliest expiry. Each expiration is shown in the provider’s time zone and your device’s local time, so you can see which will expire first.
If a provider does not supply an expiration, the app shows that the information is unavailable. Refresh to check for updated details; opening the details or refreshing does not redeem a reset.
Widgets and refresh
Keeping the view current
How do reset alerts work?
When an account refreshes successfully, Usage Overview schedules an alert for the reset time reported by that provider. By default, it only alerts you when the limit was at least 80% used, and you can choose a different threshold or mute an individual account. The alert is scheduled by iOS, so it can arrive with the app closed; refreshing again replaces it if a rolling reset time has moved.
Why has my widget not updated yet?
iOS decides when widgets receive their background refresh time. Usage Overview requests updates, but it cannot force a widget to refresh on a fixed minute-by-minute schedule. Open the app and refresh the account if you need the latest number immediately.
Why does an account show an authentication or refresh error?
Credentials can expire, be revoked, or lose the permission required to read usage. Use Replace to scan a new pairing code or enter a new credential. For an API key, create a dedicated key where the provider permits it rather than reusing a key that protects production work.
Why are the limits different from the provider’s site?
Usage Overview presents the data returned by the provider and refreshes it on demand or on the selected schedule. Providers can update their usage calculations, windows, or reporting cadence. Refresh first; if the difference remains, contact support with the provider name and a redacted screenshot of the displayed usage figures only.