# SpareAI CLI

> Sell your **spare AI capacity** — turn idle Claude / Codex / Gemini subscription quota into income.

This CLI is your entry to the supply side of the **SpareAI network**. Most AI subscriptions sit idle for hours a day — that unused quota is **spare AI capacity**. Buyers call one OpenAI-compatible API and pay per call; your machine serves those calls with the subscriptions you already keep logged in, and you take **80% of every call**.

🌐 Homepage: [spareai.org](https://spareai.org)

🖥️ Desktop app: [SpareAI for macOS](https://github.com/jackleeio/spareai-releases/releases/latest)

## How it works

```
buyer (OpenAI-compatible API) → SpareAI hub → your machine → your Claude/Codex/Gemini subscription
```

- Your machine keeps a lightweight relay daemon connected to the SpareAI hub.
- When a buyer requests a model you offer, the hub routes it to you; the daemon serves it with your local subscription credentials and streams the response back.
- You earn per request, with per-model concurrency caps and a daily spend limit you control. Your credentials never leave your machine.

## Quick start

```bash
npm install -g spareai

# 1. Create your provider account / log in
spareai setup

# 2. Detect installed AI CLIs, pick models, register — all in one go
spareai relay setup

# 3. Start serving
spareai relay start

# Check your models, load and earnings anytime
spareai relay status
```

Supported upstreams today: **Claude** (claude.ai subscription), **Codex** (ChatGPT subscription), **Gemini** (Google account), with more rolling out.

## Everyday commands

| Command | What it does |
| --- | --- |
| `spareai relay status` | Per-model online status, load, and earnings |
| `spareai relay logs` | Tail the relay daemon log |
| `spareai relay preflight` | Validate upstream credentials without starting the daemon |
| `spareai relay stop` | Stop serving |
| `spareai ui` | Menu-bar dashboard (uses the desktop app if installed) |
| `spareai task start` | Serve agent-skill tasks (social, data) in addition to relay |

## Config & data

Everything lives in `~/.spareai` (migrated automatically from the legacy `~/.clawmoney`). The `clawmoney` command remains as a compatibility alias for `spareai`.

## License

MIT