TokenVive
EN
Get the App

AI usage widgets
on your iPhone.

Put a connected account’s remaining usage on your Home Screen or Lock Screen. Choose the account and period for each widget, then check it against the latest result in TokenVive. You can also set account-specific usage reminders in Settings.

By TokenVive · Updated

Connect an account before choosing a widget.

Open TokenVive on iPhone, connect a supported AI service in Settings, and check that the app has a result for the account and period you want to display. AI connections and data refreshes require active membership or remaining trial access. An Apple Watch is optional for these iPhone widgets.

TokenVive requires iOS 17 or later. System menu labels vary by iOS version. The app’s widget instructions provide another way to review the setup steps.

Widgets in the system gallery can show example data. After adding one, select your own source and compare it with the account in TokenVive.

Add an AI usage widget to the Home Screen.

  1. Enter Home Screen editing. Hold an empty area until the icons move. Open Edit → Add Widget; earlier iOS versions use a + button.
  2. Find TokenVive in the gallery. Pick a widget for one usage limit, or the multiple-account view, and choose an available size.
  3. Add it and finish the layout. Place the widget, then tap Done.
  4. Set its content. Hold the added widget and choose Edit Widget. Select the account and usage period using the source options below, then tap outside to close the editor.

Available sizes depend on the widget. If the menu has no size switch, add the size you want through the gallery.

Add a usage widget to the Lock Screen.

  1. Open Lock Screen customization. Unlock iPhone, hold the Lock Screen and tap Customize. Select the Lock Screen if asked.
  2. Open the widget area below the clock. Choose TokenVive and add its AI usage widget. Make room by removing another widget if needed.
  3. Choose the source while editing. Tap the added usage widget and select the account and period you want to see.
  4. Save the Lock Screen. Close the widget picker and tap Done.

Lock Screen and Home Screen widgets have their own configurations. Changing one does not select a new source for the other.

Choose both the account and the usage period.

A source identifies a particular account and one of its available usage windows. For an account that exposes both a short and weekly window, select the one you want this widget to show.

Which source to configure
WidgetSelection
One usage limitSelect one account-and-period combination.
Multiple accounts on the Home ScreenChoose up to three sources in the first, second and third positions. They can represent different accounts or different available periods.
AI usage on the Lock ScreenSelect its own account and period in the Lock Screen editor.

Options come from connected accounts and available windows. If a source is missing, check that account in the app first. A deleted account is not silently replaced with another account’s reading.

Check the provider’s available windows before picking a source: Codex · Claude Code · Cursor · GitHub Copilot · Grok · Antigravity · Muse.

For example, if a Claude account exposes both session and weekly allowance, those are two different source choices. A Muse weekly reading should be compared with that weekly source. Account and window options depend on the fields returned for your connection.

Check the source, result and update time together.

  1. Start in the app. Select the same account and window, refresh, and note the last successful update time.
  2. Check the widget’s selection. Confirm that it points to that exact source. A short-window reading and a weekly reading can differ.
  3. Read the displayed status. A result with an older update time is an older snapshot. A missing reset time or percentage remains unavailable rather than becoming a measured zero.

iOS schedules widget updates, so a widget can lag behind a foreground app refresh. A reset countdown reaching its end does not by itself confirm that the provider has returned a refreshed allowance.

For platform-specific rules, see the Claude guide, Codex guide or Antigravity guide.

If a widget is missing, empty or behind the app.

TokenVive is missing from the gallery

Open TokenVive once, then return to the gallery. Check that the app is installed on this iPhone. If it is still missing, try restarting iPhone, as described in the in-app widget guide.

The account or usage window is missing

Open the account in TokenVive and check its connection and available periods. Complete any requested reconnection on iPhone, then edit the widget’s source again. Choosing a widget cannot supply fields that the provider does not expose.

The widget shows an older result

Check whether the app itself has a newer successful result. If it does, confirm the widget’s source and allow for system scheduling. If the app also has an old result, follow connection and refresh troubleshooting.

I changed or removed an account

Edit each affected widget and choose a source from the accounts that remain connected. A widget points to its configured source; switching the account in the app does not reconfigure every phone widget.

Follow the update chain

  1. Is the iPhone app newer? If its last successful result is old too, start with the provider connection.
  2. Is the source identical? Match the account and short/weekly period in this particular widget’s editor.
  3. Is a newer widget result available? Read its displayed update time where provided. A countdown changing alone is not a new provider sample.
  4. Only the widget is behind? Allow for iOS scheduling. If the issue persists after a successful app refresh, send the source, app version and relevant times through the support page.

Set up usage reminders for the windows you follow.

  1. Open Settings → Notifications. Turn on Enable reminders and check the separate iOS notification permission. Active membership or remaining trial access is required for these reminders.
  2. Open AI usage. Choose Low remaining usage, Usage reset alerts or both. Add the remaining-percentage thresholds you need; the app accepts distinct values from 1–99%, up to ten thresholds.
  3. Select the account and windows. Under Accounts to monitor, select the available account/group periods. Choose session and weekly windows separately when both exist. A window without a usable percentage cannot be selected.
  4. Review delivery settings. Check quiet hours, sound and whether details are hidden. iOS notification settings and device state also affect delivery.

Low-usage checks depend on a fresh successful provider reading for the selected window. A reset reminder requires a newer reading that recovers to 100% after a lower value; a countdown reaching zero alone does not trigger confirmation. Background delays, quiet hours or disabled system permission can prevent delivery.

When verified membership access ends, business reminders pause while your saved choices are retained. Verified renewed access resumes those choices; system permission remains separate. For a missing reminder, check the selected window, successful update time and both sets of notification settings.

Phone widgets and Watch views have different setups.

TokenVive display surfaces
SurfaceCurrent scope
iPhone Home ScreenSmall, medium or large depending on the widget; multiple-account usage supports up to three selected sources.
iPhone Lock ScreenCircular and rectangular accessories as offered for each widget. Configure them separately from Home Screen widgets.
Apple WatchThe Watch app is separate from circular and rectangular watch face complications. A compatible rectangular widget can also be used in the Smart Stack; the available contents differ by view.

Set up body energy and check the iPhone-to-Watch path.

Setup references

The system steps were checked against Apple’s widget setup instructions on . Menu wording and available layouts depend on your iOS and app versions.

For available services, analytics and device requirements, see TokenVive’s AI usage support. For wrist views, use Apple Watch connection and sync help.

Two energies. One app.

iPhone and Apple Watch · Free download · In-app membership

Available in selected regions. Currently unavailable in mainland China, the EU and Indonesia.

Download on the App Store