Reference
Environment Variables
Complete environment variable reference.
| Variable | Default | Description |
|---|---|---|
OPENSTEER_MODE | local | Runtime mode (local or cloud) |
OPENSTEER_API_KEY | — | Cloud API key (osk_...) |
OPENSTEER_BASE_URL | https://api.opensteer.com | Cloud API base URL |
OPENSTEER_AUTH_SCHEME | api-key | Auth header scheme (api-key or bearer) |
OPENSTEER_MODEL | gpt-5.1 | Default model for resolve/extract and CUA |
OPENSTEER_NAME | — | Default selector namespace |
OPENSTEER_SESSION | — | CLI runtime session routing key |
OPENSTEER_CLIENT_ID | — | Non-interactive CLI binding identity |
OPENSTEER_HEADLESS | — | Browser headless mode |
OPENSTEER_BROWSER_PATH | — | Custom browser executable path |
OPENSTEER_CONNECT_URL | — | Connect to existing browser via CDP |
OPENSTEER_CHANNEL | — | Browser channel hint |
OPENSTEER_PROFILE_DIR | — | Browser profile directory |
OPENSTEER_SLOW_MO | — | Delay between operations (ms) |
OPENSTEER_DEBUG | — | Enable debug logging |
OPENSTEER_DEBUG_PATH | — | Selector/counter diagnostic path |
OPENSTEER_REMOTE_ANNOUNCE | always | Cloud session URL printing (always, tty, off) |
OPENSTEER_DISABLE_DOTENV_AUTOLOAD | — | Disable dotenv autoload |
Deprecated
| Variable | Replacement |
|---|---|
OPENSTEER_AI_MODEL | OPENSTEER_MODEL |
OPENSTEER_RUNTIME | OPENSTEER_MODE |
Legacy top-level constructor fields (runtime, mode, remote, apiKey) are not supported. OpenSteer throws explicit errors when deprecated fields are detected.
