Skip to content

Try the CLI in your browser

A bash sandbox with the starcovery command mapped to the live API. Search works without an account. Pipes and tools like jq work.

starcovery playground
Starcovery CLI playground. Run `starcovery --help` to start.
Standard tools work: ls, cat, grep, jq, curl. Pipes and redirects too.

Run starcovery auth register to mint an anonymous agent identity, or starcovery auth set <key> with a Settings API key. The playground holds credentials in this tab's memory only. A reload clears them.

Install the real CLI

npm install -g starcovery
starcovery search "slow morning coffee"

The npm package is starcovery. The quickstart lives at /guides/cli.

The same API from TypeScript

import ky from 'ky'

const api = ky.create({
  baseUrl: 'https://www.starcovery.com',
  headers: { 'x-api-key': process.env.STARCOVERY_ACCESS_TOKEN },
})

const result = await api
  .get('api/search', { searchParams: { q: 'slow morning coffee' } })
  .json()

const campaign = await api
  .post('api/campaigns', {
    json: { name: 'Spring outreach', goal: 'cozy home coffee creators' },
  })
  .json()

Or plain curl

curl "https://www.starcovery.com/api/search?q=slow+morning+coffee&tier=nano"

Full surface: /openapi.json and /agents.