ctx Live context window
How full a session's conversation is right now. The gauge turns red as it nears full.
a single session · resets when the conversation does
3 live in your menu bar, right now
Tama
A tiny macOS menu-bar cat that watches your local AI coding-agent sessions.
See how many Claude Code, Codex, Gemini, and Antigravity sessions are running — grouped by project, with live context and today's tokens. Read-only, local-only, never touches the network.
macOS 13+ · free · open source
macOS blocked it? How to open
- Open it once anyway. Double-click Tama — in the “can’t be opened” dialog, click Done (not Move to Trash).
- System Settings → Privacy & Security. Scroll down to the “Tama was blocked” message and click Open Anyway.
- 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.
What it shows
One glance, then the whole picture.
A pixel cat and a count sit in your menu bar; the count is how many sessions are active right now. Click it for the full picture, grouped provider → folder → session.
3 agents active
meow~ Rename app opus-4-8 48.2k~$1.40 3m
Fix tests opus-4-8 43.2k~$1.65 8m
no sessions active right now
TODAY
CC 1.2M ~$4.10 CX 240k ~$0.80
tap any number · ctx live context · today total incl cache · fresh in+out · in input · out output · cache rd cache reads · cache wr cache writes
↑ a real, clickable dropdown — expand a provider or folder
- 3The count is live. It's how many agent sessions are running this second — nothing more.
- ▾ tama-widgetGrouped by where you work. Provider, then project folder, then each session, newest first.
- The bar is the context window. It fills and turns red as a session's conversation nears full.
- TODAYThe daily tally. Every session's tokens added up, cache reads included.
0 agents active
zz No sessions active right now.
TODAY
CC 1.2M ~$4.10 CX 240k ~$0.80
tap any number · ctx live context · today total incl cache · fresh in+out · in input · out output · cache rd cache reads · cache wr cache writes
Nothing running? The cat curls up for a nap.
When no sessions are active the count drops to 0 and Tama goes quiet — no noise, no nagging.
The one confusing bit
Two token numbers — and they're not the same thing.
Tama shows both, side by side. Here's the difference, once and for all.
TODAY Cumulative tokens used today
Across every session, including cache re-reads — every turn re-reads the whole context, so this runs far larger.
1.2Mtokens today
all sessions combined · grows all day
Both numbers are real and useful. In the app, tap any number to break it down into input, output, cache-read, and cache-write.
A look around
More of the app.
Pin a window, tune the look, peek at the about screen — every pixel rendered live, light and dark.
3 agents active
meow~ CLAUDE CODE
tama-widget (2)
Rename app opus-4-8 48.2k 6 ~$1.40 3m
Fix tests opus-4-8 43.2k 12 ~$1.65 8m
CODEX
TODAY
CC 1.2M ~$4.10 CX 240k ~$0.80
tap any number · ctx live context · today total incl cache · fresh in+out · in input · out output · cache rd cache reads · cache wr cache writes
Settings
Appearance
System Light Dark
Text size
S M L
Preview
3 agents active
CC 1.2M ~$4.10
Close
Yours to arrange.
Keep it tucked in the menu bar, or pin a window and let it breathe. Match your system theme or lock it light or dark. Bump the text size. Tama gets out of the way.
- Resizable pinned window
- Light · Dark · System
- S · M · L text size
- Launch at login
Provider support
What Tama can see, by tool.
Four agents, two levels of detail. Tama reads whatever each tool writes to its own logs.
| Provider | Active + folder | Live ctx | Today's tokens | Model | Est. cost |
|---|---|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | ✓ | ✓ | ✓ |
| Gemini CLI | ✓ | — | — | — | — |
| Antigravity | ✓ | — | — | — | — |
Gemini CLI and Antigravity appear by folder and recent activity only — their logs carry no token counts.
Install
Up and running in three steps.
No terminal, no account, no setup. Download, drag, open.
-
Download
Grab
Tama.dmg— it's free and about the size of a photo. -
Drag to Applications
Open the
.dmgand drag Tama into your Applications folder. -
Open it once
First launch: macOS blocks unsigned apps, so open it via System Settings → Privacy & Security → Open Anyway (steps below). It only asks once; the cat then appears at the top-right of your menu bar.
Download Tama.dmg macOS 13+ · menu-bar app macOS 13+ · Apple silicon & Intel
macOS blocked it? How to open
- Open it once anyway. Double-click Tama — in the “can’t be opened” dialog, click Done (not Move to Trash).
- System Settings → Privacy & Security. Scroll down to the “Tama was blocked” message and click Open Anyway.
- 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.
FAQ
The honest answers.
Is it safe?
Yes. Tama is read-only and local-only — it reads your AI tools' own log files, never writes to them, never runs commands, and never connects to the internet. A test in the project snapshots your logs before and after each scan and proves they're byte-identical.
macOS says Tama is blocked — how do I open it?
That's expected — Tama isn't notarized by Apple yet, so macOS holds it on the first launch only. Open it once anyway and click Done, then go to System Settings → Privacy & Security, scroll to the "Tama was blocked" message, and click Open Anyway → authenticate → Open. After that it launches normally. (On macOS Sequoia the old right-click → Open shortcut no longer works; this is the path that does.)
Does it cost money?
No — Tama is free and open-source (MIT). The ~$ it shows are estimates, not a bill.
Which tools does it work with?
Claude Code and Codex get full detail (live context, today's tokens, model, estimated cost). Gemini CLI and Antigravity show project + recent activity only.
Will it slow my Mac?
No. It makes one small, cached, read-only pass over local logs every few seconds and otherwise sits quietly in the menu bar — no background daemon.
Is any data sent anywhere?
Never. No analytics, no telemetry, no update checks, no network code at all. Everything stays on your Mac.