stim 1.2.0 → 1.3.0

package/README.md

@@ -77,6 +77,17 @@ Stim builds or restores the app, installs it, launches it, and checks launch
 readiness. Plain output streams progress and reports the complete result. Use
 `--json` when a script needs structured data.
 
+To use an existing EAS development build, run `stim ios --eas-profile ios-simulator`
+or `stim android --eas-profile development` with your project's profile name.
+The profile must be an internal development build. Add `--device` for a connected
+phone; iOS requires `ios.simulator: true` for a simulator and false for a phone.
+Stim downloads a matching native build and connects it to the workspace's Metro.
+EAS CLI manages the downloaded artifact cache. An iOS provisioning failure
+points to EAS device registration and rebuild commands.
+On a miss it stops and prints the EAS build command, which may incur charges;
+it never triggers the build automatically. See `stim guide lifecycle eas` for
+setup, environment handling, and cache behavior.
+
 Use `stim ios --scheme "App Staging"` when a project has several shared Xcode
 app schemes. Combine it with `--configuration Release` if needed. Without the
 flag, Stim keeps its automatic scheme selection. Explicit schemes use separate
@@ -167,3 +178,22 @@ Update programmatic imports from `stim-cli/cache-manifest` to
 `stim/cache-manifest`. The `@stim-cli/*` packages keep their names.
 
 MIT License.
+
+### Multiple devices in one workspace
+
+Use a stable slot name for each simulator, emulator, or physical device. Slots
+can use identical models and all share the workspace's Metro server and build
+cache. Omit `--slot` to reuse your existing default device.
+
+```sh
+stim ios --slot phone
+stim ios --slot tablet --device-type "iPad Pro 13-inch (M4)"
+stim ios --slot hardware --device <udid>
+stim logs --slot tablet --source device
+stim stop --slot tablet
+```
+
+`stim status` shows every slot. Plain `stim stop` stops the whole workspace;
+`--slot` preserves the shared server and other devices. `stim reload ios` or
+`stim reload android` can reload multiple connected devices. Read
+`stim guide lifecycle options` for launch verification and recycling behavior.