iPhone companion to the Alfred workflow

Aeye

Keep an eye on Cursor, Claude & Grok Bot — from your Lock Screen.

The same overview as the Alfred workflow — on iPhone, Home Screen widgets, and Apple Watch.

Motivation

Dashboards are a context switch.

You bounce between Cursor and Claude. You don’t want to open two billing pages mid-task just to see how much quota is left.

Glanceable on iPhone

Check quotas before a long session — from a widget or the app — without hunting through web dashboards.

One layout, two platforms

Cursor, Claude, and Grok Bot in the same rows you already know from Alfred.

Matches how products report usage

Composer/Auto vs other models; hourly vs weekly — not a flattened “tokens used” blob.

Companion, not a replacement

Built for people who already use Aeye for Alfred and want the same glance away from the Mac.

Features

Everything Alfred shows — on your phone.

Free, open source, no account, no backend. Credentials stay in the iOS Keychain.

Same rows as Alfred

Composer / Auto, Other models, Grok Bot, Hourly, Weekly with green → yellow → red circle meters.

Home Screen & Watch

Medium / Large iPhone widgets, plus an Apple Watch app and complications — synced from the phone, no tokens on the Watch.

Cursor spending parity

Same split as Cursor’s spending page; included compute spend vs plan included limit; days until reset.

Claude session + weekly

5-hour hourly window and weekly limit, with the same period suffix and pace emoji as the Mac workflow.

Pace at a glance

🐢 underspending · 🎯 on track · 🔥 overspending — compares % spent vs % of the period elapsed (±8pp band).

60-second cache

Avoids re-hitting undocumented APIs on every glance; pull to refresh when you need a fresh read.

Configurable rows

Toggle which rows appear — same idea as Alfred’s Configure Workflow checkboxes.

Private by design

No Aeye servers. Tokens on-device only. Usage fetched directly from Cursor / Anthropic.

Reading the numbers

Same grammar as Alfred.

If you already learned the Mac workflow, the iPhone view should feel familiar on day one.

Composer / Auto 🟢⚪⚪⚪⚪⚪⚪⚪⚪⚪ 13.0% (🕐 68%, 11d, Tue Aug 21) 🐢
… · $39.85 / $20.00
Other models ⚪⚪⚪⚪⚪⚪⚪⚪⚪⚪ 0.0% (🕐 68%, 11d, Tue Aug 21) 🐢
…
Grok Bot ⚪⚪⚪⚪⚪⚪⚪⚪⚪⚪ 1.0% (🕐 14%, 6d, Fri 12pm) 🐢
Pro · Grok Bot Plan · weekly included
Hourly 🟢⚪⚪⚪⚪⚪⚪⚪⚪⚪ 6.0% (🕐 40%, 5h, 11:30pm) 🐢
plan=… · experimental
Weekly ⚪⚪⚪⚪⚪⚪⚪⚪⚪⚪ 1.0% (🕐 14%, 6d, Tue 8pm) 🎯
plan=… · experimental

Setting up

Build once. Glance forever.

Sideload with Xcode (free Apple ID works). Not on the App Store yet — intentional for a free companion for Alfred users.

  1. Clone alfred-aeye and open ios/Aeye.xcodeproj (or run xcodegen generate from ios/).
  2. Set your Team on Aeye, AeyeWidgetExtension, AeyeWatch, and AeyeWatchWidgets.
  3. Confirm App Groups: group.com.giovanni.aeye (iPhone) and group.com.giovanni.aeye.watch (Watch).
  4. Run on your iPhone (Watch app installs with it). Sign in to Cursor and Claude in Settings, then Refresh.
  5. Add the iPhone widget (Medium/Large) and optional Watch complications from the watch face editor.

Details and troubleshooting live in the repo’s ios/README.

Alfred + iPhone + Watch

One product, three surfaces.

On the Mac, type aieye in Alfred. On the phone, check the widget. On the wrist, glance a complication. Same meters, same pace, same story.

Aeye Alfred workflow overview screenshot

Privacy & caveats

Your tokens stay on the device.

No Aeye account

Nothing is uploaded to a third-party usage dashboard. The app only talks to Cursor and Anthropic for numbers you already can see.

Undocumented APIs

Cursor and Claude usage endpoints can change without notice — same risk as the Alfred workflow.

Sign in once on iPhone

iOS can’t read Cursor’s local session DB the way the Mac workflow does, so you sign in to each service in Safari. Tokens land in the iPhone Keychain and refresh themselves.

Free for Alfred users

Not for sale. Built as a companion — share the source, build it yourself, keep the layout familiar.