Osworld Reset

Reset the OSWorld environment. Soft mode clears step counter only. Hard mode calls DesktopEnv.reset() to revert to snapshot state.

bdambrosio Updated 10 repo stars

File contents

OSWorld Reset Tool (Level 4)

Input

  • mode or value: string (required) - "soft" or "hard"
    • soft: Clear step counter only, no state change
    • hard: Call DesktopEnv.reset() to revert environment to snapshot state

Output

  • Note ID (bound to out variable) containing:
    • text: formatted reset result
    • format: "text"
    • metadata: reset data including:
      • success: boolean - whether reset succeeded
      • mode: string - reset mode used
      • step_counter: integer - step counter after reset (0)

Configuration

  • OSWORLD_URL environment variable (defaults to http://localhost:3002)
  • Or pass osworld_url in character config's osworld_config section

Common Workflow

{"type":"osworld-reset","mode":"hard","out":"$reset"}
{"type":"osworld-observe","out":"$obs"}
{"type":"osworld-execute","python":"pyautogui.click(100,200)","out":"$result"}

Notes

  • Soft reset: Only clears step counter. Useful for reflection without losing state.
  • Hard reset: Reverts environment to snapshot state. Critical for counterfactual replay and reflection.
  • Hard reset is the key reflection enabler - allows Jill to explore "what if" scenarios.

bdambrosio/cognitive_workbench commit 3c5bd7f961

Frequently asked questions

npx get-skill add bdambrosio/osworld-reset