iOS + Widget + Mac Connector + Cloud Relay

T.T Token Tracker

Mobile-first AI coding usage tracking after linking a trusted Mac source. No provider API keys, no cookies, no auth files.

Download T.T Connector View setup

Early release · macOS Connector is Developer ID signed and notarized

Status Early release

Relay Cloudflare Workers + D1

Sync Sanitized UsageSnapshots only

Widget Latest cached status

Setup

Pair your Mac, then watch usage from iPhone.

Install Connector

Download the notarized macOS Connector and open it from your Mac.

Pair iPhone

Scan the QR code or enter the 6-digit code. Pairing works through Cloud Relay, even off LAN.

View snapshots

Dashboard and widgets show latest known Claude Code and Codex status with freshness labels.

Quick Start

What every tester should do first.

T.T needs one trusted source before it can show real Claude Code or Codex usage. The iPhone app is the viewer; the Mac Connector is the source.

1. Download on Mac

Install the notarized DMG, open T.T Connector, and allow macOS to open the Developer ID app.

Open Mac download guide

2. Pair from iPhone

In T.T Connector, create a pairing code. In the iPhone app, choose Link T.T Connector and scan or type the code.

3. Keep it running

The Connector uploads sanitized snapshots about every 30 seconds while your Mac is awake. Enable Open at Login so it resumes after restart.

4. Check Diagnostics

If a provider is missing or stale, open Connector Diagnostics to see Claude source, Codex source, parser errors, and upload time.

Architecture

Accurate tracking starts from a trusted local source.

The iPhone app never pretends to know real usage by itself. Without a linked Connector, it shows setup. With a linked Connector, it displays the latest sanitized snapshot.

Claude Code / Codex CLI

T.T Connector for macOS

T.T Cloud Relay

iOS App + Widget

Troubleshooting

How to read the first run.

No data on iPhone

Open T.T Connector on your Mac, confirm it is paired, then press Refresh Now. The iPhone app shows setup until a source is linked.

Claude shows tokens only

Local Claude logs can expose token counts without subscription limits. Claude limit percentages need the sanitized statusLine bridge.

Codex weekly differs

T.T presents active-window remaining first. Weekly remaining appears as additional limits when Codex local data exposes both windows.

Widget looks stale

Widgets read the iPhone App Group cache. Open the iPhone app after pairing to refresh the latest cached snapshot.

Mac was asleep

macOS can pause the Connector and network during sleep. T.T shows latest cached data, then syncs again shortly after the Mac wakes.

Tester Feedback

Send the symptom, not your secrets.

Support bundles are designed for early-user reports. They include sanitized app and Connector state, not provider credentials or raw provider content.

1. Capture the issue

Note what you expected, what happened, the provider affected, approximate time, and whether a screenshot is attached.

2. Copy iPhone state

Open iPhone Settings in T.T Token Tracker, refresh diagnostics, check widget cache, then choose Copy Support Bundle.

3. Copy Mac state

Open T.T Connector Diagnostics, refresh sources, confirm parser/upload status, then choose Copy Support Bundle.

What I expected:

What happened:

Provider affected:
Claude Code / Codex / Widget / Pairing / Other

Approx time:

Screenshot attached:
Yes / No

iPhone Support Bundle:

Mac Connector Support Bundle:

Privacy

Built around a narrow sync promise.

Never synced

Provider API keys, cookies, OAuth tokens, session keys, auth files, and raw logs.

Allowed snapshot fields

Provider id, usage percent, reset time, status, confidence, observed time, and optional token counts.

Clear labels

Every provider card exposes source, confidence, and last updated time.

Mac Connector

Download T.T Connector

Use this early Mac build to pair your iPhone and upload sanitized local CLI usage snapshots.

Download DMG SHA-256