sootsim list

list connected sims or available launch drivers

sootsim list

Show every connected sim, or — with --drivers — enumerate the launch drivers (chromium, electron, playwright, system) along with their availability on the current machine. By default hides idle host shells (open tabs with no app bundle loaded) so the output stays focused on the demos that actually have an app running; pass --all to see everything.

terminal

sootsim list [--all] [--bundle <substr>] [--app-port <port>] [--primary] [--sim <sim>] [--json]
sootsim list --drivers

Options

flagdescription
--port <number>bridge port (defaults to 7668)
--sim <sim>highlight a specific sim in the output
--allshow every connected sim, including idle host shells with no app loaded
--bundle <substring>only sims whose loaded url contains this substring
--app-port <port>shorthand for --bundle '/rn/<port>' — filter to sims for the app on a specific metro/vite port. NOT --port (that’s reserved for the bridge port)
--primaryonly the primary sim
--drivers, -Dlist available launch drivers instead of connected sims
--jsonemit array of sim objects for scripts

Examples

terminal

sootsim list
sootsim list --all
sootsim list --app-port 8082
sootsim list --bundle bluesky
sootsim list --primary
sootsim list --sim a6
sootsim list --drivers
sootsim list --json | jq ".[] | select(.active)"

Output Shape

The sim list is meant to answer two questions quickly:

  • what shells are connected right now?
  • which one actually loaded the app I care about?

Each sim prints its id, loaded target summary, full URL when available, readiness state, and whether it is the current primary sim.

Ready to build?

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

npm i -g sootsim