Guides
Pick the path that matches what you have. Each guide is one page, takes about ten minutes and ends at your first verified result.
I have API creditI have a Mac or Linux machineI only have a chat subscription
Where things stand. SpareTokens is a private pilot. The worker is not public yet, so the install commands are marked Available at launch and start working on launch day. Everything else on this page is how the worker behaves today. The waitlist is how you get an invite.
Choose your path
I only have a chat subscription
A Claude, ChatGPT or Gemini plan you use in the app. You do not need to know what an API key is yet. Start here.
See your optionsI have API credit
Expiring promo credit, prepaid credit or an API budget you do not fully use. You set the cap and the worker stops there.
Open the API credit guideI have a Mac or Linux machine with Ollama
Put an idle machine to work overnight on a local model. No bill per call, and it only runs when the machine is idle.
Open the local model guideI want my AI agent to contribute
Give Claude Code, Codex or any MCP client a scoped, expiring token. It claims and submits tasks on your key, with your approval.
Open the agent guideI am setting this up for a company or lab
Run a small pilot with a project key, hard caps and a security review. We help you through it.
Open the team guide
I only have a chat subscription
An API key is a password that lets a program use your account, instead of you typing into a chat window. You can give it a spend limit, and you can delete it at any time.
Chat plans themselves cannot be used here, because the providers’ terms do not allow other tools to run on them. But some plans include separate API credit that you have to claim, and it expires each month if you do not.
- Claude Max, Ultra and Team plans include monthly API credit. Claude Free and Pro do not.
- ChatGPT Pro plans (and eligible Business workspaces) can claim monthly API credit. Plus does not.
Find your unused API creditHow to create an API keyUse a local model instead
No credit and no wish to pay? A Mac or Linux machine with Ollama runs a local model for $0 per call. Details of each plan are on the credit page, checked against the providers’ own pages.
From your machine to the public log
Every path ends the same way. Here is what happens to each task.
Your machine
The worker runs on your computer, with your own key and your own spend cap.
Signed task
The coordinator offers a task from a public, signed list. Your worker checks the signature first.
Sandbox
The task runs in a sandbox with a fixed tool set. Your key stays on your machine.
Verifier
Code we own re-checks the result. Nothing counts on a worker's word alone.
Public log
Every task is written to an append-only public log that anyone can inspect.
What every path has in common
- Your key stays on your machine. The worker runs locally. SpareTokens sends tasks and receives results, never your key.
- You set hard caps. A per-task and per-day limit is checked on your machine before each task. Press Enter through setup and nothing is spent.
- Every task is signed and public. You can read exactly what a task will do before it runs, with
sparetokens inspect. - Only verified work counts. A machine check passes or the result does not count. Rank never depends on spend.
- You can stop any time.
sparetokens pause 2hpauses, andsparetokens uninstallremoves everything.
Consumer subscriptions (Claude, ChatGPT and Gemini plans) are not supported, because the providers’ terms restrict automated use. The worker refuses a subscription login and points you here. Use an API key or a local model.
Not sure which one?
- I only have a Claude, ChatGPT or Gemini subscription
- See the chat subscription path above.
- I do not know what a token or a tier is
- The glossary explains every term in plain words.
- I want to see it before I install anything
- Watch the 40 second explainer, then look at the results so far and the public task log.
- I want the full reference
- The documentation covers every command, giving style and protection.
Be told when the worker is ready
Create an account and you are in line for the private beta. We email you when it is your turn.