privacy
What leaves your machine, what we store, and how to get rid of it.
Last updated 18 September 2026.
the short version
tokn uploads counts. One row per day, per tool, per model. No prompts, no replies, no code, no file paths, no repository or project names, no branch names. We do not run analytics or advertising, and we do not sell anything to anybody.
what the tool reads on your machine
Your AI tools write session logs to disk already. tokn reads those files and nothing else. Today it reads Claude Code, Claude Desktop, Codex CLI, GitHub Copilot CLI and opencode.
Those logs contain your prompts and the model's replies. tokn opens them to pull out token counts and model names, then throws the rest away in memory. It never copies the conversation anywhere, and it only reads: the files are not modified.
Some tools keep usage on their own servers rather than on disk. Cursor is one. We cannot read that, and tokn sources tells you so rather than quietly counting it as zero.
what gets uploaded
Every row looks like this, and there is no other kind of row:
{
"day": "2026-09-18",
"tool": "claude-code",
"model": "claude-opus-5",
"requests": 214,
"input": 41233,
"output": 88120,
"cacheWrite5m": 0,
"cacheWrite1h": 1904221,
"cacheRead": 9241882,
"costUsd": 12.41,
"fast": false
}Alongside it we get your timezone name, so days line up, and the CLI version. The aggregation happens on your machine before anything is sent, so there is nothing finer-grained for us to leak even if we wanted it.
Run tokn sync --dry-run to print the exact payload without sending it, or tokn scan to see your numbers without an account at all.
your account
A password account stores your handle and a scrypt hash of your password. We never see the password itself. No email address is required, and we do not ask for your real name.
Signing in with GitHub stores your GitHub numeric id, your login name, and whatever is on your public profile: display name, bio, avatar and website. The app asks GitHub for read access to your profile and email addresses and can do nothing else. It cannot see your repositories, private or public. Disconnect it from your settings whenever you want.
Anything you add yourself (display name, bio, links) is optional and public.
linked machines
When you link a machine we store a hash of its token, plus the hostname, the operating system name and the CLI version, so you can tell your laptop from your desktop on the account page. The token itself is stored only as a SHA-256 digest, so somebody who stole the database still could not sync as you.
what is public
Your handle, display name, bio, links, avatar, daily totals, the models and tools you use, your rank and your join date all appear on the leaderboard and on your profile page. Anyone can see them without signing in.
Your password hash, device tokens, hostnames and session cookies are not public and are never shown to other users.
cookies
One cookie, called tokn_session. It holds a random session id, nothing else, and it exists so you stay signed in. It is http-only and expires after thirty days. There are no tracking cookies and no third party scripts, so there is no cookie banner to click through.
where it lives
Data is stored with Appwrite, on servers in the United States. They hold it on our behalf and do not use it for anything of their own. Signing in with GitHub sends a request to GitHub, which has its own privacy policy.
how long we keep it
Usage rows stay until you delete them. Sessions expire after thirty days. Link codes expire after ten minutes.
Deleting your account from settings removes your profile, your usage history, your linked machines and your sessions. It is immediate and we do not keep a shadow copy. Backups roll off within thirty days.
your rights
You can see everything we hold about you on your own profile and account pages, edit it in settings, or delete all of it. If you want a copy as a file, or you want something corrected that the settings page will not let you change, ask and we will sort it out.
Depending on where you live you may have further rights over your data. Those apply here too. Exercising any of them costs nothing.
age
There is no age limit. tokn collects token counts, not personal details, and we see no reason to gate a leaderboard behind a birthday field we would have no way of checking.
changes and contact
If this policy changes, the date at the top changes with it. Material changes get a notice on the site.
Reach us through the toknlabs GitHub. The terms of use cover the rest.