Guide

How to track Claude Code & Codex token usage on macOS

Tama watches all your local AI coding agents — Claude Code, Codex, Gemini CLI, and Antigravity — from the menu bar, with the two token numbers that actually matter. Here's how to read it, end to end.

  1. Install Tama

    Download Tama.dmg, drag Tama into Applications, then open it once via System Settings → Privacy & Security → Open Anyway (it's not notarized yet — steps below the button). A pixel cat appears at the right of your menu bar.

  2. Read the menu-bar count

    The number next to the cat is how many AI coding-agent sessions are running right now — across Claude Code, Codex, Gemini CLI, and Antigravity. When nothing is running it drops to 0 and the cat naps.

  3. Open the dropdown

    Click the cat for the full picture, grouped provider → project folder → session, newest first. Each session shows its live context gauge.

  4. Check your token usage

    Claude Code and Codex sessions show ctx (live context window) and feed the TODAY total — every session's tokens for the day, cache re-reads included. Gemini CLI and Antigravity show folder and recent activity only.

  5. Pin it to keep it on screen

    Click the pin icon to pop Tama out of the menu into a floating window that stays on top while you work — with full session names, per-session message counts, and each provider's daily total. Close it to drop back to the menu-bar dropdown.

Confused by the two token numbers? See context window vs daily tokens.

Download Tama.dmg macOS 13+ · free · open source
macOS blocked it? How to open
  1. Open it once anyway. Double-click Tama — in the “can’t be opened” dialog, click Done (not Move to Trash).
  2. System Settings → Privacy & Security. Scroll down to the “Tama was blocked” message and click Open Anyway.
  3. Confirm. Authenticate with Touch ID or your password, then click Open. After this, Tama launches normally.

Tama isn’t notarized yet, so Gatekeeper holds it on first launch — one time only.