Claude Code token-optimisation orchestrator

Install TokenGem

TokenGem installs as a Node command line tool on macOS or Linux. Download the release, verify its checksum, then run doctor, baseline, install and dashboard in that order: the baseline must be captured before anything is installed, because once a hook is live the pre-install numbers cannot be recovered.

Last updated 2026-09-05 · applies to TokenGem 1.x

Current release: 1.0.1 released 2026-09-05

Download tokengem-1.0.1.tgz

sha256 bfae98665e64a24cd4c662ac273d7fca129213a7f0894e4bab0ac96d3fb272db · checksums.txt · release feed · what changed

What you need

macOS or Linux, Intel or Apple Silicon.
Node.js 20 or newer.
At least one supported agent: Claude Code, Codex CLI, Cursor CLI, OpenCode, GitHub Copilot CLI, Gemini CLI or Qwen Code, or an app that calls a model API directly.
For the managed components: uv and npm. tokengem doctor checks all of this before anything is changed.

Verify the download

shasum -a 256 tokengem-*.tgz     # compare with checksums.txt above
tar -xzf tokengem-*.tgz
cd tokengem-*/
npm link                         # or: ln -s "$PWD/bin/tokengem" /usr/local/bin/tokengem

TokenGem demands a checksum of its own upstream downloads before extracting them; it meets the same bar for itself.

Four commands, in this order

tokengem doctor      # reads your machine, names every hook and every conflict. Changes nothing. Free.
tokengem baseline    # freezes your pre-install medians, per agent. Free. Do this BEFORE install.
tokengem install     # snapshot -> pinned runtimes -> one router per agent. Needs your key.
tokengem dashboard   # http://127.0.0.1:7801

install refuses to run without a baseline. Once a hook is installed the pre-install numbers are gone, and a savings figure with nothing to compare against is a marketing artifact, not a measurement.

Activate the key from your receipt first: tokengem license activate KEY. Verification is a local signature check with no network; the key is in the body of the receipt, and the resend page sends it again if you lost it.

And one that undoes all of it

tokengem uninstall restores the settings snapshot taken before install, byte for byte, and removes the managed runtime. The ledger is kept with --keep-ledger.

Updates

tokengem update reads the release feed once, on request, and prints the newest version with its download URL and checksum. It installs nothing; install a newer release the same way you installed this one. Every 1.x release published within twelve months of purchase is included in the price; the pricing page says what happens after that.