@spinwait/cli
v0.1.2
Published
SpinWait CLI — get paid while your AI thinks. Shows one sponsored line in your agent's status line.
Readme
@spinwait/cli
Get paid while your AI thinks. One sponsored line in your agent's status line; you keep 50% of the ad revenue.
The SpinWait CLI registers itself as your AI coding agent's status line. While the agent is "thinking", it shows a single small sponsored line — and you earn. It reads only the status-line state, never your code, prompts, or completions. Open-source (MIT).
Install & log in — step by step
# 1. Install
npm i -g @spinwait/cli
# 2. Log in (device-code flow — works in any terminal)
spinwait login
# → prints a URL + an 8-character code.
# → open the URL, sign in (GitHub / Google / email), enter the code, approve.
# → expected: "✓ Logged in as [email protected]"
# 3. Turn it on in Claude Code (writes the statusLine setting for you)
spinwait enable
# → expected: "✓ Enabled in Claude Code (~/.claude/settings.json)"
# 4. Set up payouts (Stripe Express — Stripe handles ID + bank)
spinwait payouts
# 5. Verify
spinwait status
# → shows account, balance, payout status, and your referral linkManual Claude Code setup (if you'd rather not run enable)
Add this to ~/.claude/settings.json:
{
"statusLine": { "type": "command", "command": "spinwait statusline" }
}Commands
| Command | What it does |
|---|---|
| spinwait login | Log in via device code |
| spinwait enable / disable | Toggle the status line in Claude Code |
| spinwait status | Account, balance, payout status |
| spinwait balance | Available balance |
| spinwait payouts | Open Stripe Express payout setup |
| spinwait pause / resume | Temporarily stop / resume showing ads |
| spinwait logout | Remove the local token |
Configuration
- Token + settings:
~/.spinwait/config.json(chmod 600). - Point at a self-hosted instance:
export SPINWAIT_API_URL=https://your-host.
Privacy
The client only ever reads whether the agent is "thinking" and renders a line. It never accesses your code, prompts, completions, or files.
