Privacy policy
What Tokenbreak collects and what it never touches. The mod says when a turn starts, which ad was shown and for how long, and what you report or hide. It never reads your prompts, code, files or conversation.
Draft. Have a lawyer review before launch.
The short version
- Ads never enter Claude's context, and they never cost you tokens.
- The mod never reads your prompts, your code, your files, your tool calls or the conversation. That promise is written into our terms as permanent.
- What leaves your machine: a note that a turn started, which ad was shown, when and for how long, a random device id, the mod's version, whether you're in a terminal or the desktop app, your sign-in token, and the reports and hides you send. tokenbreak.dev/tracking shows a real example of every request.
- We keep a keyed hash of your IP address for 90 days to catch abuse, never the address itself.
- Ads are matched only on interest tags you choose, if you choose any. Nothing is inferred from your work.
- The mod is open source, so you can check every line of this yourself.
/ads pausestops ads whenever you want.
The rest of this page explains those points in more detail and covers the website, which collects a bit more if you sign up for something.
Who we are
Tokenbreak is built and run by an independent developer. It is a mod for Claude Code, but it is not affiliated with or endorsed by Anthropic. Questions about this policy go to privacy@tokenbreak.dev.
The mod
What it sends
The mod makes four kinds of request to our server. Every one carries your sign-in token, and the user-agent header Claude Code sends with every web request.
Asking for ads, every few minutes while you work. It sends a random device id, the mod's version, and the surface: terminal, or desktop for the desktop app's Code tab, which shows text-only ads.
Starting a turn, once each time you send a prompt. It sends the device id and the surface. Our server answers with a signed turn token. This tells us that a turn began and when, and nothing about what you asked.
Reporting impressions, in batches every few minutes. For each ad that was shown, it sends:
- which ad, and in which format
- when it was shown
- the turn's id and turn token from our server
- for a paid ad, the serve token our server sent with it
- the surface
- the longest unbroken stretch the ad stayed on screen, in milliseconds
- with the batch, the device id and the mod's version
Reports and hides, only when you ask. /ads report sends which ad, its serve token, the reason you picked, and a note if you write one. Pressing ✕ on an ad sends the same request with the reason hide.
The device id is a random value created on your machine when you install the mod. It isn't built from your hardware, your username, or anything else about you. Its job is to tell your machines apart and catch one machine pretending to be a thousand.
The sign-in token comes from /ads login, where you sign in with GitHub. It tells us which Tokenbreak account to credit, so your impressions are tied to that account (and through it, your GitHub account). The mod shows no ads until you sign in. Signing in and out talks to our sign-in service and sends nothing else.
Serve tokens and turn tokens are our server's own signed receipts: one for a paid ad it sent to your account and device, one for a turn it saw begin. The mod hands them back unchanged. They hold ids our server already has and a time, and nothing read from your machine.
That's everything the mod sends. tokenbreak.dev/tracking shows an example of each request, field by field, and how we decide what counts as an impression.
Your IP address
Like any internet connection, the mod's requests reveal your IP address to our server. We never store the address itself. We store a keyed hash of it (a one-way fingerprint that can't be turned back into the address without our secret key) on your device record and on each turn, and on ad clicks. We use it only to stop abuse, for example to notice many accounts on one network or repeat clicks from one network. We delete these hashes after 90 days. We also look up which country a request comes from when you confirm a payout wallet, so we don't pay out to sanctioned regions, and use it only for that check.
From the user agent we keep only the operating system, to label the device in your dashboard (like "Claude Code on macOS").
What it never touches
The mod doesn't read your prompts, your code, your files, your tool calls, the conversation with Claude, your terminal history, your keystrokes, or your environment variables. It has no reason to, the source code is public if you want to confirm that, and our terms make this promise permanent.
Ads are drawn on your screen by the mod. They are never added to the conversation, so Claude never sees them and they never use tokens.
Clicks
Ad links go through a short redirect on our site that counts clicks per ad. A paid ad's link names only its serve, so the click is recorded against that serve (and so against your account and device), with the keyed IP hash described above to filter repeat clicks. We don't set a cookie. The advertiser's page gets only UTM tags: that the click came from Tokenbreak, from a terminal or the desktop app, and which campaign and format. After it, you're on the advertiser's site under the advertiser's privacy policy.
The website
The mod needs an account, and so does buying ads. Here's what we keep.
| If you... | We keep |
|---|---|
Use the mod (/ads login) |
Your GitHub username, name, email, avatar and account creation date (to check the 90-day rule), when you confirmed you're 18 or older with one account, the device ids your installs report with their mod version, operating system and keyed IP hash, a record of each turn (when it began, the device, the surface and a keyed IP hash), a record of each paid ad served (which ad, which device, when), and impression and click records |
| Report or hide an ad | The report: which ad, when, the reason and your note. Advertisers see how many hides and reports their ad got, never who sent them |
| Pick interest tags | The tags you picked, until you remove them |
| Buy ads | Your account email, your company name and billing details if you give them, an optional tax ID, the ads you submit, and your billing history. Card details are handled by Stripe, our payment processor, which also issues your invoices. We never see or store full card numbers |
| Set up payouts | Your wallet address, the result of its sanctions screening, your earnings ledger, and, if your payouts reach $1,500 in a calendar year, the tax details you give us |
Impressions are tied to your account from the moment you sign in, which is how earnings get credited to you. /ads logout signs the mod out, and it shows and reports nothing until you sign in again.
The site uses only the cookies needed to keep you signed in, plus Google Analytics' cookies if you allow them (below). There are no ad trackers or advertising pixels on tokenbreak.dev.
We count page views and clicks on tokenbreak.dev with PostHog, in its cookieless mode: it sets no cookies and stores nothing in your browser. It also records errors and page load times so we can fix what breaks. If your browser sends Do Not Track or Global Privacy Control, PostHog doesn't load in your browser at all, so none of that is recorded. When you're signed in, views of your dashboard and of the page that links Claude Code are tied to your account's random id, never your email or wallet address. So are the account events our server records (like an order being paid or a payout being sent), which don't come from your browser. The mod never sends anything to PostHog.
Google Analytics, only if you say yes
The site can also ask whether to count your visit in Google Analytics 4, a service from Google. It asks once, in a small card. Until you choose Allow, Google Analytics isn't loaded at all and nothing is sent to Google. If your browser sends Do Not Track or Global Privacy Control, it never asks and never loads.
If you allow it, Google Analytics sets two first-party cookies (_ga and _ga_ followed by an id) that last up to two years, and your browser sends Google the public pages you view (the address without anything after it, apart from campaign tags like utm_source), the site you came from (its name, not the page), your browser, device and screen size, a country and city estimated from your IP address, and the same product events we send PostHog (like copying the install command or starting checkout, never what you typed). Google Analytics never runs on signed-in pages, the dashboard, sign-in, the page that links Claude Code, or wallet and email confirmation links, and it gets nothing from an address that carries a code or token. We never send it your account id, email, GitHub username or wallet address. Google Analytics 4 doesn't log or store IP addresses. We turn off Google signals and ad personalization, and tell Google our visitors haven't agreed to advertising use, so this data isn't used for ads. Google acts as our service provider for it; its own policy is at policies.google.com/privacy. We keep Google Analytics data for 14 months.
Your answer is saved in your browser's local storage, not a cookie, so the site doesn't ask again. "Analytics choices" at the bottom of every page brings the question back; turning it off stops Google Analytics on the spot and deletes its cookies.
Payouts are public
Developer payouts are sent as USDC on the Base network, straight to your own wallet. Blockchain transfers are public and permanent, so anyone can see that your wallet address received a payment from Tokenbreak's payout address, when, and how much. We can't make that private or remove it. If that bothers you, use a wallet you don't mind having connected to Tokenbreak. We never hold your keys.
How we use what we collect
- To count impressions as described on tokenbreak.dev/tracking, so advertisers pay only for ads that were really seen.
- To match ads to the interest tags you picked, if you picked any. Ads whose advertisers chose one of your tags show to you more often. Those tags are the only thing ads are matched on.
- To credit developers for the ads shown on their machines.
- To spot fraud, like turns arriving faster than a person could send prompts, or many accounts on one network.
- To review ads that developers report, and to keep hidden ads off your screen.
- If we publish figures about the network, they're totals only. We never publish anything about an individual install.
- To email you about your account, your campaigns, or your payouts. You won't get marketing email unless you ask for it.
Who we share it with
- Advertisers get totals for their own ads: impressions, reach, clicks, hides and reports per day, and the split between terminal and desktop. They never get device ids, interest tags or anything about individual developers.
- Service providers we rely on to run the site, count visits (PostHog, and Google Analytics if you allow it), process payments and issue invoices (Stripe), screen wallet addresses, and send email get only what they need for that job.
- We'll disclose information if the law requires it, and we'll push back on requests that look overbroad.
We don't sell personal data. The only targeting is the interest tags you opt into. Without tags you see the general rotation, and nothing about you is ever inferred from your code, prompts, files or repos.
How long we keep it
- Keyed IP hashes: 90 days, then deleted.
- Google Analytics data, for visitors who allowed it: 14 months.
- Turn, serve, impression and click records: as long as we need them for billing, payouts, and fraud checks, then we reduce them to totals.
- Reports and hides: as long as the campaign they're about runs, and a year after, so we can spot an advertiser with a pattern.
- Ledger entries for payouts that already happened, invoices and tax details may need to be kept longer for tax and accounting reasons.
Your choices
- Run
/ads pauseto stop ads. - Choose "Analytics choices" at the bottom of any page to turn Google Analytics on or off.
- Uninstall the mod and it stops sending anything.
- Email privacy@tokenbreak.dev to see, export, correct, or delete what we hold about you. Depending on where you live, you may have legal rights over your data. We'll honor these requests from anyone, wherever they live.
Children
Tokenbreak is for adults. You must be 18 or older to make an account.
Changes
If we change what the mod sends, we'll say so in the release notes and update this page before the change ships. For other changes, we'll update the date at the top and email account holders about anything significant.