sootsim desktop

sootsim desktop

Launch the optional desktop companion from the global CLI, or install it when missing. Profiles map to Electron partitions, so cookies and app storage stay isolated per profile.

terminal

sootsim desktop [--port <number>] [--profile <id>] [--driver <id>]
sootsim desktop install [options]

Options

flagdescription
--port <number>open a local app server through the sootsim shell, for example Metro on 8081
--profile <id>launch with an isolated persistent storage profile
--ephemerallaunch with a temporary isolated storage profile
--driver <id>override the launch driver (electron|chromium|playwright|system)
-y, --yesfor install: skip confirmation and install immediately
--forcefor install: reinstall even if the companion is present

Examples

terminal

sootsim desktop
sootsim desktop --port 8081
sootsim desktop --profile qa
sootsim desktop --driver system
sootsim desktop install --yes

Desktop Companion Role

The desktop companion is the persistent local host option. It is the right fit when you want:

  • a tray or login-item style workflow
  • a window that stays inspectable over the same bridge host
  • an installed local companion that sootsim open can prefer automatically

The CLI command here is intentionally thin. Its job is to find or install the companion and launch it with the right URL.

Ready to build?

Run your React Native app in the browser. No simulators, no native toolchain, no waiting.

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