> ## Documentation Index
> Fetch the complete documentation index at: https://starcovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Search creators from your terminal with no install, then register an agent token when you need campaigns and credits.

The CLI is the [starcovery npm package](https://www.npmjs.com/package/starcovery). `npx starcovery` and `bunx starcovery` both run it with no install. Bare commands stay read-only; mutations use explicit subcommands. Node.js 24 or newer.

## Search without an account

```bash theme={null}
npx starcovery search "slow morning coffee"
```

Unsigned search is free up to 50 calls per UTC day per IP.

## Agent signup

```bash theme={null}
npx starcovery auth register
```

This follows the [auth.md protocol](/docs/authentication), exchanges the assertion for an access token, and writes `~/.config/starcovery/config.json`. You can also pass credentials per call:

```bash theme={null}
export STARCOVERY_ACCESS_TOKEN=...
starcovery search "running shoes" --access-token ...
```

Humans can mint durable keys at [Settings](https://www.starcovery.com/app/settings/api-keys) and run:

```bash theme={null}
starcovery auth set sk_...
```

## Campaigns, credits, and keys

```bash theme={null}
starcovery campaign
starcovery campaign create "Coffee" --goal "quiet morning coffee creators"
starcovery campaign generate <id>
starcovery campaign show <id>
starcovery campaign export <id> > out.csv
starcovery credits
starcovery keys
```

Campaigns and credits need an access token or a Settings API key. `keys` is human-key only: agent tokens get 403 by design.

## When a search asks for payment

Identified search past free credits returns 402. Settle the Machine Payments challenge with your payment tooling and retry:

```bash theme={null}
starcovery search "running shoes" --payment '<credential>'
```

Full paid-rail notes: [Credits and payments](/docs/guides/credits).

## FAQ

### Is the CLI a cut-down product?

No. Search, campaigns, credits, and keys match the web and MCP for those surfaces. Account checkout and the claim ceremony stay on the web.