DEV Community

hon6
hon6

Posted on AI-assisted

Your Claude Code 5-hour and weekly limits on the iPhone home screen: a look at Kiteline's widgets

Kiteline is a tool for managing coding agents: Claude Code, Codex and others do the work on a computer, and you follow progress, reply and approve permissions from your phone. The desktop side (Mac, Windows, Linux) is open source. No API key, no changes to the agents' configuration.

Claude subscriptions meter usage in two windows: a 5-hour window and a weekly window. A common way to find out you're close to the edge is a long task stopping halfway with a limit message. Checking ahead of time used to mean going back to the computer and asking Claude Code.

Kiteline's iPhone app (version 1.16) added two home-screen widgets that put those numbers where you'll actually see them.

What the widgets show

Quota & Usage

  • Small: a ring for whichever limit window is most used (for example "weekly 68%") plus today's tokens.
  • Medium: today's tokens and estimated cost on the left; on the right, 5-hour and weekly bars for up to two agents, one row per computer. Bars turn red above 90%.
  • Lock screen: the percentage in a circle, or agent name, two windows and today's tokens in a rectangle.

Sessions

  • Small: how many sessions are waiting for your confirmation (a big orange number), or how many are working if none are waiting.
  • Medium / large: 3 or 6 sessions, one per row, with status, title and what each is waiting for or doing.
  • Lock screen: a line like "2 waiting ยท 3 working".

Tapping a session row opens that session, so a pending permission request is one tap away. Tapping the quota widget opens the usage report (today / 7 days / 30 days, by model and by project, with Codex, OpenCode and Qwen Code tokens included).

Since macOS 14, a Mac can place iPhone widgets on its desktop, so Mac users get the same widgets without a separate Mac version.

Where the numbers come from

Kiteline has a firm rule: it never touches Claude's credentials and never calls Anthropic's API. So the limit readings aren't fetched with your account. Claude Code's own responses already carry the limit information; Kiteline records those readings locally through an extension point Claude Code provides, and the desktop app reads them. Codex's limits come from the rate_limits field in its own session files under ~/.codex/sessions.

The trade-off: a reading is only as fresh as the agent's last request, so the widget shows the time of the data when it's more than five minutes old.

How a widget stays current without networking

The widget extension doesn't open any network connections. Instead:

  • While the app is open, it writes a compact snapshot (counts, the 8 most urgent sessions, today's usage, limit windows) whenever something meaningful changes, and asks WidgetKit to reload.
  • When the app isn't running, the notification extension updates the snapshot as pushes arrive ("waiting for you", "finished", "error"), so "who's waiting on me" stays accurate.
  • The snapshot is shared through a shared keychain item rather than an App Group, because App Groups need registration in the developer portal and Kiteline builds entirely from the command line.

If the app has never been opened or the phone is unpaired, the widget says so instead of showing sample numbers.

Getting it

  • Desktop: search GitHub for hon6/kiteline (Mac, Windows, Linux).
  • iPhone / iPad: search "Kiteline" on the App Store.
  • Free on the same Wi-Fi; remote access away from home needs a subscription.

Claude Code is a product of Anthropic; Kiteline is an independent third-party tool.

Top comments (0)