Syrtis
GitHub
EN 中文
Σύρτις
From σύρω, to drag: sand carried along until it settles into shoals.

Where your tokens settle.

Syrtis is a free, open-source macOS menu-bar app, with a tray version for Windows, that reads the session logs already on your computer to show what your AI coding tools cost. It tallies tokens and spend across 25+ agents on-device, with no account, no telemetry, and no cloud sync.

brew install --cask nanako0129/tap/syrtis
Requires Apple Silicon and macOS 14 or later. The Homebrew tap command is provisional until v2.0 ships. The app is not notarized, so install it through Homebrew: the cask clears the quarantine flag that would otherwise block it.

Reads session logs from 25+ tools, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Copilot, Kiro, and Antigravity.

Tokens settling into shape

A single prompt barely registers on a bill, but thousands of small completions accumulate over weeks of work. Syrtis scans the local logs left by your coding agents to reveal what has settled.

A year of usage as a 3D contribution terrain
A year of token usage rendered as an orbitable 3D terrain, stacked by model or agent in tokens or dollars.

The dashboard, one lens at a time

Overview

Shoals beneath calm water

In Acts 27, sailors caught in a storm moved first to avoid running aground on the hidden shoals of Syrtis. Provider usage limits pose the same hazard: invisible beneath normal work until requests abruptly stop.

The menu-bar item keeps that limit visible as signal bars, a ring, or a popsicle that melts as the quota drains. The gauge shifts to amber under 25% remaining and red under 10%. Limit cards show whether consumption is ahead of or behind pace, projecting when you will run out at this rate.

25% or more
under 25%
under 10%

On macOS 27, the dashboard opens over the wallpaper as a Liquid Glass panel.

Menu barScreenshot pending: to be captured from the v2.0 build.
The menu-bar item at actual size.

Measuring the day

In 1659, Christiaan Huygens sketched a recurring dark patch on Mars, tracking its daily return to determine that Mars rotates in roughly 24 hours. That patch is now called Syrtis Major: the first surface feature recorded on another planet, and the first used to measure a planet's day.Christiaan Huygens, Mars observations, 1659

AI allowances run on windows of their own: a few hours for a live session, and weekly resets for larger pools. Syrtis counts down to each reset, preserves the history and cost of past windows, and maps out which hours of the week the allowance goes.

Quota
The Quota lens: past windows and weekly usage patterns.

Contained on your machine

On-device parsing

Syrtis extracts tokens and costs directly from the log files your tools already store on disk, powered by the vendored tokscale-core library. No session data ever leaves your computer.

Zero accounts, zero telemetry

There are no accounts, no analytics beacons, and no tracking IDs. Syrtis operates without a cloud backend and performs no synchronization.

Explicit network boundaries

Outbound network calls are limited to the signed update feed, public pricing tables, and vendor quota endpoints, each contacted only when your own credentials for that vendor are present locally, such as Claude, Codex, Copilot, or Grok. Each endpoint receives only its own credentials; nothing is sent anywhere else.

Previously TokenBar

Until version 2.0, the macOS app was called TokenBar. It is now named after the ancient Greek shoals formed by settling currents, and the Martian landmark that measured a day. Upgrading to v2.0 preserves your settings, history, and login item unchanged.

Why Syrtis: an essay on the name

tokscaleby Junho Yeo — its tokscale-core parses, deduplicates, and prices usage; its terminal interface served as the model for the lenses.
tokcatby handlecusion — where the product line began, and the source of the spinning oiiai cat in the menu bar.
RunCatby Takuto Nakamura — the original menu-bar pet that runs faster the busier you are.
CodexBarby Peter Steinberger — the reference for how quota pace is shown.

Install Syrtis

Pick your platform. Both versions are free and MIT-licensed, sharing the same Rust parsing core for on-device logs.

brew install --cask nanako0129/tap/syrtis
Requires Apple Silicon and macOS 14 or later. The Homebrew tap command is provisional until v2.0 ships. The app is not notarized, so install it through Homebrew: the cask clears the quarantine flag that would otherwise block it.