Skip to content
TOKENBREAK
Sheet 1/1How it works

Pixels next to your prompt. Nothing more.

Tokenbreak is a small mod for Claude Code and a self-serve ad desk. Here's the whole loop, from install to payout, and the parts of Claude Code it deliberately never touches.
Sheet 2/3The loop

1. Install the mod

Two commands inside Claude Code. The mod is a plugin of function hooks: it draws in a band above the prompt, in the status line, and in a side pane. Nothing else.

2. A banner rotates above the prompt

One labeled line, rotating every ~40 seconds. It steps aside when Claude Code shows a survey, and /ads pause hides it for an hour or the day.

3. Theater opens while Claude works

On a wide fullscreen terminal, a pane slides in when a turn starts and out when it ends. Narrower terminals just keep the banner.

4. One turn, one count

When a turn finishes, the mod queues one impression for the banner that was showing. Batches go out every few minutes. No code, prompts or replies are ever in them.

5. You earn half

Advertisers pay per thousand impressions. Half of that goes to the developer whose terminal showed it, paid in USDC once you pass $10 and the 30-day hold.

claude

⏺ Plugin installed: tokenbreak@tokenbreak

⏺ Restart Claude Code to load it.

/plugin install tokenbreak@tokenbreak
claude
Percolating…(0s · esc to interrupt)
AdTokenbreakThis slot is for rent. $12 per thousand looks.
claude · fullscreen
Percolating…(0s · esc to interrupt)
what gets sent
POST /api/v1/impressions
{
  "deviceId": "7f3c…",
  "impressions": [
    { "adId": "house-rent", "format": "banner",
      "at": 1791063354000, "turnId": "t_91" }
  ]
}
That's the whole payload.
claude

⏺ Done. All tests pass.

opus · ~/app
◆ USDC 0.612 today
Sheet 3/3Never hooked

Three hooks Tokenbreak will never use.

Claude Code mods can do a lot. These are the ones that could read or shape your conversation, so the mod doesn't register them, and a test in the repo fails if anyone adds one.
prompt.compose

Changes the system prompt. Ads would cost you tokens and could steer Claude.

session.append

Sees every message in the conversation.

tool.call

Sees every file read, edit and shell command.

Try it

/plugin marketplace add tokenbreak/tokenbreak