A workspace is a persistent local directory tree under .opensteer/workspaces/<id>/. It stores browser profile data, registry artifacts, traces, and runtime session state.

.opensteer/
  workspaces/
    <workspace-id>/
      browser/          # Cloned browser user-data directory
      registry/         # Request plans, recipes, auth recipes, descriptors
      artifacts/        # Screenshots, captured scripts, JSON data
      traces/           # Interaction trace runs
      live/             # Active session state
      observations/     # Observability and telemetry data

Registry subdirectories:

registry/
  request-plans/
  recipes/
  auth-recipes/
  descriptors/
  interaction-traces/
  reverse-cases/
  reverse-packages/
  reverse-reports/

Create a Workspace

SDK:

const os = new Opensteer({ workspace: "my-workspace" });

CLI:

npx opensteer open https://example.com --workspace my-workspace

Persistence

Workspaces persist across sessions. Cookies, local storage, and full browser state carry over between open / close cycles.

Add .opensteer/ to .gitignore:

.opensteer/