Every token.
Every model.
One clear view.

Track AI usage, costs and plan limits — right from your desktop.

macOS Windows Linux

A quiet glance at your usage. Right at the notch.

Illustrative macOS demo
Works with your toolsCodexClaude CodeGeminiKimiOllamaAnd more

Build alongside
the community.

View leaderboard

Share the activity you choose. Find your people, compare usage and follow your progress.

Community previewSample data
Illustrative community rankings, not live standings
RankBuilderTokensActivity
01N nova18.6M
02T tess15.2M
03K kai12.8M

At home on
your desktop.

A glance at the notch. A widget on your desktop. The full picture when you need it.

Small, medium and large widgets. Five time windows.
Available on macOS 14 and later.

Token HorizonDemo
Tokens today1.84M

Provider usage and activity, at a glance.

Next reset2h 14m

Claude · 5-hour window

The details.
Without the digging.

From your first request to your local inference stack, everything has a place.

Read the documentation

Tokens, costs & limits

Usage by tool and model, history, activity heatmaps and provider reset windows.

Your Mac & local models

CPU, memory and I/O alongside MLX and Ollama telemetry, measured throughput and supervised inference engines.

Look inside a request

An optional local gateway captures traces, timing and provider-reported usage. Request bodies stay on your machine.

In your workflow

Shell history, the th CLI, a local HTTP API and MCP tools bring the same view into your terminal and coding agent.

Your data.
Your call.

Usage tracking stays on your device. Publish a community profile only when you choose. Prompt sharing is off by default.

How your data is handled

Your next token,
accounted for.

Choose your desktop. Install the app.
Keep your usage in view.

No account needed for local tracking. Your data stays on your machine unless you choose to share.

The macOS app includes the notch and desktop widgets. Windows and Linux use the desktop dashboard.

Full installation guide

Token Horizon for macOS

Apple silicon · macOS 14 or later

  1. Open the disk image

    Drag Token Horizon into Applications.

  2. Launch Token Horizon

    Open it from Applications. Your usage lives at the notch and in the dashboard.

Install with Homebrew or Terminal
Homebrew
brew tap castlemilk/tap
brew install --cask token-horizon
curl -fsSL https://raw.githubusercontent.com/castlemilk/token-horizon/main/install.sh | bash

The one-line installer also enables crash recovery and sets up the th shell helper. Inspect the installer.

Token Horizon for Windows

Windows 10 or 11 · Intel / AMD 64-bit

  1. Run the installer

    Open the downloaded .exe and choose where to install. It installs for your Windows account.

  2. Open Token Horizon

    Launch it from the Start menu or desktop shortcut.

  3. Set up tracking

    Choose which tools the app can read or meter in the tracking setup guide. Keep the app open while tracking.

Windows installation help

This installer is currently unsigned, so Windows may show a security prompt. Review the release and checksum before deciding to open it. Windows ARM64 is not a native build target.

To update, close Token Horizon and run the newer installer. You can uninstall it from Windows Settings → Apps.

Windows setup and troubleshooting

Token Horizon for Linux

64-bit desktop · x64 or ARM64

Debian / Ubuntu: use the .deb package. Other distributions: use the AppImage for your architecture.

  1. Install or open your package
    Install the downloaded .deb with your package manager, or allow the AppImage to run as a program in file properties.
  2. Open Token Horizon

    Use your application menu for .deb installs, or open the AppImage.

  3. Set up tracking

    Choose which tools the app can read or meter in the tracking setup guide. Keep the app open while tracking.

Linux installation help

Check your architecture with uname -m: x86_64 means x64; aarch64 means ARM64. A graphical desktop is required.

AppImage needs FUSE 2. On Ubuntu 24.04, install libfuse2t64. If your system restricts Chromium’s sandbox, use the .deb package on Debian or Ubuntu.

To update, close the app and install the newer .deb or replace your AppImage.

Linux setup and troubleshooting

Inside Token Horizon

Swipe the preview to explore the details ↔

01 / 07

Interactive tour · illustrative data · not connected to your accounts