Quick Start

#Install SootSim

curl -fsSL https://sootsim.com/install.sh | sh

The public script installs the CLI, engine runtime, and background daemon without sudo or changes to your app. The daemon keeps the bridge running so every later CLI command is much faster.

See Installation to read the script and for the manual npm, bun, or pnpm install followed by sootsim setup.

#Open the simulator

Start your app the normal way, then open it in SootSim:

sootsim open 8081

If you omit the port, sootsim open scans for available React Native dev servers and lets you pick one.

No per-app install is needed, and no iOS native build is needed. Metro, Expo, or One running locally is enough. If no bridge is running, sootsim open starts a local foreground bridge for you; the guided setup installs the faster background daemon.

The desktop app is optional. If it is installed, open prefers it; otherwise SootSim opens in your default browser.

Run sootsim --help to get an overview of common commands.

Your agents benefit from the sootsim skills that guided setup offers during onboarding; you can also install them later with sootsim skill install.

#Run a Maestro test

Create .maestro/smoke.yaml:

- launchApp: {}
- waitFor:
    text: 'Welcome'
    timeout: 10000
- tapOn: 'Get Started'
- assertVisible: 'Home'
- takeScreenshot: home

Run it with:

sootsim maestro test .maestro/smoke.yaml

Want a shareable cloud preview? Sign in once, then run the flow with --preview. It records the run, uploads it, and prints a shareable /preview/<id> link (--preview-open also opens it in your browser):

sootsim login
sootsim maestro test .maestro/smoke.yaml --preview --preview-open