Skip to content
Sheet 1/3How 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. 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@tokenbreak
  2. 2. 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.

    claude
    Percolating…(0s · esc to interrupt)
  3. 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 · fullscreen
    Percolating…(0s · esc to interrupt)
  4. 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 sent
    POST /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. 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 · example
    tokenbreak.dev/dashboard/earn
    Today
    $0.02
    7 days
    $0.13
    Pending, in the 30-day hold
    $0.41
    Available
    $0.00
    Paid weekly in USDC once $5 is available.
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. Everything the mod does send is on the tracking page.
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 steven-3/tokenbreak