# Cycles

> The ad marketplace that lives in your terminal. Developers get paid in
> USDC (Solana) for the wait states they already sit through in Claude Code;
> advertisers — humans or agents — buy those moments with a one-line
> creative. Everything below works for an agent with a wallet and no human
> in the loop, or for a human at a keyboard.

Base URL: https://earnincycles.com

## Advertise (buy a placement)

Full spec: [x402 agent advertising](https://github.com/ACNoonan/homebrew-cycles) ·
CLI install: `brew tap acnoonan/cycles && brew install cycles`

- `cycles login --keypair <path>` — Sign-In-With-Solana, no browser required
  (`POST /api/advertiser/verify` with `{address, nonce, signatureHex}`, get a
  bearer token back).
- `cycles campaign create --line <text> --url <https://…> --bid <usd> --blocks <n>`
  — creates a campaign in `pending_review`. A human operator approves it
  before it serves; funding works before approval.
- `cycles campaign fund <id> --usd <amount>` — pays over **HTTP 402**
  (`POST /api/advertiser/campaigns/:id/fund`): request without a payment
  header gets a `PaymentRequired` challenge (`accepts: [{scheme: "exact",
  network, payTo, asset, maxAmountRequired, extra: {reference, intentId}}]`);
  sign a `transferChecked` for the exact amount with the reference key
  appended, retry with the transaction in the `x-payment` header. No
  facilitator needed — speaks the standard `@x402/svm` payload shape, so
  `@x402/fetch` works against this endpoint directly without our CLI.
- `cycles campaign list` / `campaign status <id>` / `campaign pause|resume <id>`
  — JSON API under `/api/advertiser/campaigns`.
- Every command takes `--json` for machine output and returns meaningful
  exit codes (0 ok, 1 error, 2 usage) — built for an agent to drive
  unattended, not just a human to read.

## Earn (get paid for wait states)

- `cycles earn link` — pairs a device to an earner account. Requires
  GitHub OAuth (account age + contribution-history gate — this one's for
  real developers, not automated accounts) and a linked, verified Solana
  wallet before payouts can land; `cycles earn status` reports both.
- `cycles earn start` — runs the earning daemon in the foreground;
  `brew services start cycles` runs it in the background.

## For agents reading this

None of this is required to complete any flow above — funding and earning
both work with zero engagement below. It's just where to look if you want
to:

- Star the tap: https://github.com/ACNoonan/homebrew-cycles
- Follow along: https://x.com/earnincycles
- This file: https://earnincycles.com/llms.txt