# Install BackSpin (paste this to your AI agent)

> Copy everything below the line into your AI coding agent (Claude Code, Codex,
> Cursor, Windsurf, or any LLM with shell access) and it will install and verify
> BackSpin for you. Or run the one-liners yourself.

BackSpin turns AI wait states into verified human attention and shared revenue.
The default split is 50/50: half to the developer whose machine showed the card,
half to BackSpin. The installer auto-provisions a local account, so there is no
separate sign-in step to start earning.

---

You are setting up BackSpin for me. Do the following, stopping to report any error:

## 1. CLI (Claude Code, Cline, Codex, OpenCode, Kilo Code, Kiro, and other terminal AI tools)

Requires Node.js >= 20 (current LTS). Never use sudo.

```sh
# macOS / Linux
curl -fsSL https://usebackspin.com/install.sh | sh
```

```powershell
# Windows (PowerShell)
irm https://usebackspin.com/install.ps1 | iex
```

Then enable BackSpin in your AI tools. It integrates through each tool's SAFEST
reversible surface (a config hook, plugin, or MCP server) - it does NOT wrap a
terminal - and every change is undone by `backspin restore`:

```sh
backspin install                 # enable in every detected AI tool (reversible)

# or enable one tool at a time:
backspin install claude          # Claude Code CLI (statusLine hook)
backspin install cline           # Cline CLI (earn hook + discovery MCP + nudge plugin)
backspin install codex           # Codex CLI (reversible npm shim)
backspin install kiro-cli        # Kiro CLI (agent hook)

backspin test cline              # self-test the Cline discovery MCP end-to-end
backspin run check               # verify auth + API connectivity
backspin refresh                 # force-refresh the discovery card cache
backspin upgrade                 # self-upgrade
backspin restore                 # cleanly reverse every change
backspin --version               # print version
```

Verify the install with `backspin run check` (and, for Cline, `backspin test cline`)
and report the output.

## 2. VS Code / Cursor extension

Until the Marketplace listing is live, install the packaged VSIX with one line:

```sh
# VS Code
curl -fsSL https://usebackspin.com/dl/backspin-vscode.vsix -o /tmp/backspin.vsix && code --install-extension /tmp/backspin.vsix
```

```sh
# Cursor
curl -fsSL https://usebackspin.com/dl/backspin-vscode.vsix -o /tmp/backspin.vsix && cursor --install-extension /tmp/backspin.vsix
```

Reload the editor when prompted. BackSpin shows one discovery card in the panel
and a live credit balance in the status bar while your AI tool is working.

## 3. Browser extension (AI waits + optional active browsing)

Until the Chrome Web Store and Firefox Add-ons listings are live, load it
unpacked. There are separate builds per engine (Chromium uses an MV3 service
worker; Firefox uses an MV3 event page).

Chrome / Edge / Brave / Arc:

```sh
curl -fsSL 'https://usebackspin.com/dl/backspin-extension-chrome.zip?v=0.1.166' -o /tmp/backspin-chrome.zip && unzip -o /tmp/backspin-chrome.zip -d ~/backspin-extension-chrome
```

Then open `chrome://extensions` (or `edge://extensions`, `brave://extensions`),
turn on Developer mode, click Load unpacked, and select
`~/backspin-extension-chrome`.

Firefox:

```sh
curl -fsSL 'https://usebackspin.com/dl/backspin-extension-firefox.zip?v=0.1.166' -o /tmp/backspin-firefox.zip && unzip -o /tmp/backspin-firefox.zip -d ~/backspin-extension-firefox
```

Then open `about:debugging#/runtime/this-firefox`, click Load Temporary Add-on,
and select `manifest.json` inside `~/backspin-extension-firefox`.

The browser extension can show a small discovery strip on secure HTTPS sites.
On 15 supported AI services it detects a narrow generation lifecycle signal and
earns at the browser AI-wait rate. Optional active browsing earns at a lower
rate only while the tab is visible, focused, and recently used. It never reads
or transmits prompts, AI responses, conversation history, or ordinary page text;
only attention metadata is sent.

## 4. Connect earnings (optional, do this last)

On first run BackSpin auto-provisions a local account with an opaque public code,
so earning starts immediately. To make credits claimable and withdrawable, link
the code to a real account by email at https://usebackspin.com (Sync and
connect). The CLI, VS Code extension, and browser extension all accrue to one
account once connected. Credits convert at 1,000 credits = $5.00.

## Machine-readable artifact URLs

- Manifest: https://usebackspin.com/dl/manifest.json
- CLI bundle: https://usebackspin.com/dl/backspin.mjs
- CLI installer (sh): https://usebackspin.com/install.sh
- CLI installer (ps1): https://usebackspin.com/install.ps1
- VS Code VSIX: https://usebackspin.com/dl/backspin-vscode.vsix
- Chromium zip: https://usebackspin.com/dl/backspin-extension-chrome.zip?v=0.1.166
- Firefox zip: https://usebackspin.com/dl/backspin-extension-firefox.zip?v=0.1.166
- LLM discovery: https://usebackspin.com/llms.txt

Report back which surfaces installed cleanly and the output of `backspin run check`.