brew install --cask fizipan/tap/buku-token
Buku is Indonesian for book. Run a few agents at once and it gets hard to tell which subscription is about to run out, or where the money went. Buku Token reads the logs your agents already write on your Mac and puts the answer one click away. There is no account to create and no telemetry, and the interface comes in English and Indonesian.
What it shows
What's left. The menu bar shows the logo and percentage left for each agent with a quota. Open it for 5-hour and weekly windows, Cursor's monthly Total, Auto and API, reset times, and a burn projection for Claude. Notifications, off by default, warn you when a quota drops below 15% or when Claude is projected to run out before it resets.
Where it went. Today's cost as a donut per agent, with the total in Rupiah and tokens, then tokens and API-equivalent cost by session, model, project and day.
Was it worth it? What you pay for a subscription next to what the same usage would cost at API prices, projected to the end of the cycle.
A card to share. An image you can copy or save, with an option to hide costs. It has no project names, paths or emails.
Supported tools
| Tool | Tokens and cost | Quota | Source |
|---|
| Claude Code | Yes | Yes | ~/.claude/projects, and Anthropic's usage endpoint with your existing login |
| Codex | Yes | Yes, as fresh as your last session | ~/.codex/sessions and ~/.codex/archived_sessions |
| OpenCode | Yes | No | ~/.local/share/opencode/opencode.db |
| Hermes | Yes | No | ~/.hermes/state.db |
| Cursor | Yes, after you connect it | Yes, after you connect it | cursor.com, with a session cookie you paste in |
| OpenRouter | Spend and balance only | Key limit, if set | openrouter.ai, with an API key you paste in |
| Antigravity | No, activity only | No | File names and dates, and three columns of its summaries database |
| RTK | Tokens saved | No | The rtk command |
OpenRouter figures are kept out of the totals because OpenCode or Hermes may already have counted the same spend.
Install
brew install --cask fizipan/tap/buku-token
You need Homebrew and an Apple Silicon Mac. Upgrade with brew upgrade --cask buku-token, and remove it with brew uninstall --cask buku-token. Adding --zap to that also deletes the app's local data.
On first run, macOS asks for access to the Keychain item Claude Code-credentials. Choose Always Allow to see your Claude quota. If you refuse, everything else still works.
The app is not notarized by Apple. It is signed with a self-signed certificate, so the cask removes the download quarantine flag to let macOS open it. If you would rather not allow that, build it from source.
You can also download the DMG from Releases. macOS blocks its first open, so go to System Settings, then Privacy & Security, and choose Open Anyway.
Intel Macs need to build from source, which has not been tested on Intel. You need macOS, Node.js, pnpm, Rust and the Xcode Command Line Tools.
1. Create a local signing certificate. You only do this once. A stable identity means macOS remembers your Keychain answer after a rebuild.
- Open Keychain Access, then choose Keychain Access > Certificate Assistant > Create a Certificate.
- Set Name to
Buku Token Local, Identity Type to Self-Signed Root, and Certificate Type to Code Signing.
- Click Create, then Continue until it finishes.
security find-identity -p codesigning will list it as "not trusted". That is expected and does not stop signing. To use another identity, change bundle.macOS.signingIdentity in src-tauri/tauri.conf.json.
2. Build it.
git clone https://github.com/fizipan/buku-token.git
cd buku-token
pnpm install
pnpm tauri build --bundles app
The app lands in src-tauri/target/release/bundle/macos/Buku Token.app. Copy it to /Applications to keep it.
Connecting Cursor and OpenRouter
Both are optional and stay off until you connect them. Open Settings, go to Agents, and choose Manage.
- Cursor: log in at cursor.com, open your browser's developer tools, and copy the
WorkosCursorSessionToken cookie. Cursor encrypts the login it stores on your Mac, so this app does not read that one. Treat the cookie like a password, because it is a full account session.
- OpenRouter: paste the API key your tools already use. Usage is counted per key, so a brand-new key shows $0.
Privacy
Your usage data stays on your Mac, in ~/Library/Application Support/local.toolslab.bukutoken.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
