1. Install the mod
Two commands inside Claude Code, then /ads login to link your GitHub account. The mod is a plugin of function hooks: it draws in a band above the prompt and in a side pane. Nothing else.
claude⏺ Plugin installed: tokenbreak@tokenbreak
⏺ Restart Claude Code to load it.
/plugin install tokenbreak@tokenbreak2. A banner shows while Claude works
One labeled line above the prompt, from the moment you send a prompt until 30 seconds after Claude finishes. Then it steps aside until your next prompt. ✕ hides that ad for 30 days, and /ads pause hides everything for an hour or the day.
claudePercolating…(0s · esc to interrupt)3. Theater opens while Claude works
On a wide fullscreen terminal, a pane slides in once a turn has run a few seconds and out when it ends. Narrower terminals just keep the banner.
claude · fullscreenPercolating…(0s · esc to interrupt)4. One turn, one count
When you send a prompt, the mod asks our server for a turn token. When the turn ends, it queues at most one impression per format: the ad that was on screen longest, if it stayed 1 continuous second (2 for Theater). Batches go out every few minutes. No code, prompts or replies are ever in them.
what gets sentPOST /api/v1/impressionsAuthorization: Bearer <your sign-in token>{ "deviceId": "11111111-2222-4333-8444-555555555555", "modVersion": "0.6.0", "impressions": [ { "adId": "00000000-0000-4000-8000-00000000ac3e", "format": "banner", "at": 1791063354000, "turnId": "turn_EXAMPLE_0001", "serveToken": "v1.EXAMPLE-serve-ids-and-expiry.EXAMPLE-signature", "turnToken": "v1.EXAMPLE-turn-id-and-time.EXAMPLE-signature", "surface": "terminal", "shownMs": 12400 } ] }That's the whole payload. Every request is on /tracking →5. You earn 50%
Advertisers pay per thousand impressions, and 50% of what they pay goes to the developer whose terminal showed the ad. Tokenbreak pays the card fees out of its own half. Your dashboard shows earnings day by day, and they're paid weekly in USDC once $5 has cleared the 30-day hold.
dashboard · earnings · exampletokenbreak.dev/dashboard/earn- Today
- $0.02
- 7 days
- $0.13
- Pending, in the 30-day hold
- $0.41
- Available
- $0.00
Three hooks Tokenbreak will never use.
prompt.composeChanges the system prompt. Ads would cost you tokens and could steer Claude.
session.appendSees every message in the conversation.
tool.callSees every file read, edit and shell command.
Try it
/plugin marketplace add steven-3/tokenbreak