Quick Start: Cloud

Setup

Set your environment variables.

# .env
OPENSTEER_MODE=cloud
OPENSTEER_API_KEY=osk_your_key_here

SDK

import { Opensteer } from 'opensteer'

const opensteer = new Opensteer({
  name: 'cloud-demo',
  cloud: true, // or set OPENSTEER_MODE=cloud
})

try {
  await opensteer.launch()
  console.log('Session URL:', opensteer.getCloudSessionUrl())

  await opensteer.goto('https://example.com')
  await opensteer.snapshot({ mode: 'action' })
  await opensteer.click({ description: 'more-info-link' })
} finally {
  await opensteer.close()
}

CLI

OPENSTEER_MODE=cloud opensteer open --name cloud-demo --url https://example.com

Notes

• Cloud mode is fail-fast — there is no fallback to local. If the API key is missing or the service is unreachable, the session errors immediately.
• View active and past sessions in the dashboard.
• The API surface is identical to local, except from(), uploadFile, exportCookies, and importCookies are not available in cloud mode.

CUA in cloud

Delegate multi-step tasks to the agent.

const opensteer = new Opensteer({
  name: 'cloud-agent',
  cloud: true,
})

try {
  await opensteer.launch()
  const result = await opensteer.agent.execute('Find the pricing page and extract plan names')
  console.log(result.message)
} finally {
  await opensteer.close()
}

The agent uses the same cloud session — no additional browser is launched.