Getting started 시작하기
- Open TokenFuel and click the
›_icon in the macOS menu bar. - Choose the coding-agent folders you want TokenFuel to read.
- If you have no local logs yet, choose Explore with demo data.
- Use the provider switcher to compare local activity and available limits.
Requires macOS 14 or later. Apple silicon and Intel Macs are supported.
Folder access 폴더 접근
TokenFuel uses the standard macOS folder picker. Access is read-only and is limited to folders you explicitly choose. A security-scoped bookmark remembers the selection across launches.
You can cancel the picker and connect later. If the selected folder contains no supported logs, TokenFuel explains the issue and lets you choose again.
Usage and limits 사용량과 한도
TokenFuel parses local token metadata in the background and stores daily aggregates on your Mac. When an official remaining quota is available in a provider’s local cache, TokenFuel shows its source and freshness. It does not invent quota percentages for providers that do not expose them.
API-equivalent value is an estimate based on public API token prices. It is not your subscription bill and does not change your provider plan.
League 리그
League is optional. You can browse public overall and per-agent rankings as a read-only guest without joining or uploading local activity.
Joining requires iCloud and explicit consent. Only an anonymous participant identifier, a random per-Mac contribution identifier, Coder alias, league scope, self-reported weekly token and session totals, streak, short model-family summary, and update time are published. Prompts, code, filenames, Saved items, and raw logs are never included.
Macs using the same iCloud account contribute separately and appear as one combined League profile. Choose Leave on This Mac & Delete Its Data to stop future uploads from the current Mac and delete that Mac's ranking records. Other Macs remain connected.
Purchases and restore 구매 및 복원
TokenFuel purchases are processed by Apple through StoreKit. In the app, open the purchase screen and choose Restore Purchases while signed in with the Apple Account used for purchase.
When Pro expires, local history is retained. TokenFuel limits only what the Free tier displays; restoring an eligible purchase makes the retained history available again.
Troubleshooting 문제 해결
No usage appears
Confirm the correct source is selected, reconnect its folder, then choose Refresh Usage. Empty or malformed log lines are skipped without crashing the app.
The menu-bar icon is missing
Open TokenFuel from Applications, then check macOS Control Center settings if menu-bar items are hidden by available space.
League cannot publish
Verify that iCloud Drive is enabled and retry. Guest browsing remains available without publishing.
A service status is unavailable
TokenFuel uses official public status endpoints and may show a recent cached result during a temporary network failure.
Contact 문의
For support, privacy requests, or League deletion help, use the monitored support contact listed on TokenFuel’s App Store page.
Include your macOS version and TokenFuel version. Never send prompts, source code, API keys, or raw log files.