Help center

Getting started

What tokenstat is, what it reads off your machine, and the one command that installs it on macOS, Linux, or Windows. Start here if you want to know where the numbers come from before you run anything, and how to remove it cleanly if you change your mind.

4 guides in Getting started.

What tokenstat counts, and where the numbers come from

Every number tokenstat shows is read from files the coding tools already wrote on your machine. Here is which files, what gets counted, and how confident each count is.

Is tokenstat safe to run?

tokenstat reads session logs that contain your prompts and your code, because counting tokens requires it. Here is exactly what it does with them, what never leaves your machine, and how that boundary is enforced.

Install tokenstat on macOS, Linux, or Windows

One command per platform, what the installer actually does to your machine, and how to opt out of the parts you do not want. Plus why installing early matters more than it looks.

Uninstall tokenstat

One line to remove the schedule and the binary, one flag to delete your archive too, and the manual steps if you would rather do it by hand. Nothing is left behind that this page does not name.