Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/steerlabs/opensteer/llms.txt

Use this file to discover all available pages before exploring further.

​
Unreleased

​
Breaking Changes

CLI runtime routing now uses --session/OPENSTEER_SESSION instead of --name/cwd/active-session fallback.Non-interactive CLI calls now require explicit runtime identity via --session, OPENSTEER_SESSION, or OPENSTEER_CLIENT_ID.CLI --name is now selector-cache namespace only and no longer controls daemon/browser routing.
Removed legacy ai config from OpensteerConfig. Use top-level model instead.OPENSTEER_AI_MODEL is no longer supported. Use OPENSTEER_MODEL.
OPENSTEER_RUNTIME is no longer supported. Use OPENSTEER_MODE.Constructor runtime selection now uses cloud (cloud: true or cloud options object). Legacy mode/remote config is removed.OPENSTEER_MODE now uses local or cloud. The value remote is no longer supported.

​
New Features

OpenSteer now enables built-in LLM resolve/extract by default with model gpt-5.1.
Added OPENSTEER_CLIENT_ID support for stable client-scoped default session binding.
Added automatic .env loading from storage.rootDir (default process.cwd()) so constructor config can consume env vars without requiring import 'dotenv/config'..env autoload follows common precedence (.env.<NODE_ENV>.local, .env.local, .env.<NODE_ENV>, .env) with .env.local skipped in test, does not overwrite existing env values, and can be disabled via OPENSTEER_DISABLE_DOTENV_AUTOLOAD.
Mutating actions now include smart best-effort post-action wait with per-action profiles and optional per-call overrides via wait.
Added structured interaction diagnostics via OpensteerActionError for descriptor-aware interaction methods (click, dblclick, rightclick, hover, input, select, scroll, uploadFile).Added ActionFailure types (ActionFailureCode, retryable, classificationSource, optional details) to support programmatic handling of action failures.Added DOM actionability probe + Playwright call-log classification to report reasons like BLOCKED_BY_INTERCEPTOR, NOT_VISIBLE, NOT_EDITABLE, and timeout/stale-target cases more accurately.
Added native skills installer commands (opensteer skills install and opensteer skills add) that wrap the upstream skills CLI to install the first-party opensteer skill pack without requiring separate global setup.

​
Improvements

  • Added per-session daemon startup locking + stale-lock recovery and ping-based health checks to remove startup races across concurrent commands
  • Added strict in-daemon request serialization for session commands, while keeping ping out of the queue for reliable liveness checks
  • Cloud mode now falls back to OPENSTEER_API_KEY when cloud.apiKey is omitted
  • Cloud action failures now accept optional structured failure details and map them to OpensteerActionError when available

​
Documentation

  • Refreshed README and getting-started guidance to match current SDK/CLI behavior and env vars
  • Added CLI reference and docs index
  • Expanded CONTRIBUTING.md and added SECURITY.md + SUPPORT.md

​
0.1.0

Initial Release

Initial open-source release of OpenSteer.

​
Features

  • Unified local/cloud execution with the same API surface
  • Descriptor-aware actions with selector persistence for replay
  • Structured extraction with typed schemas
  • CUA agent support (openai, anthropic, google)
  • HTML snapshot modes for action and extraction
  • CLI for interactive and programmatic usage
  • Automatic selector resolution and caching
  • Support for goto, click, input, select, hover, scroll, and more
  • Built-in skills for AI agent integration
For detailed release steps and versioning information, see the releasing documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us