@capgo/cli 8.99.1 → 8.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -214,6 +214,10 @@ Capgo continues to load the root config while writing only the selected source.
214
214
  - [Routes](#observe-routes)
215
215
  - 🔹 [Generate-docs](#generate-docs)
216
216
  - 🔹 [Mcp](#mcp)
217
+ - 🔹 [Simulator](#simulator)
218
+ - [Start](#simulator-start)
219
+ - [Get](#simulator-get)
220
+ - [Stop](#simulator-stop)
217
221
 
218
222
  ## <a id="init"></a> 🚀 **Init**
219
223
 
@@ -227,6 +231,7 @@ npx @capgo/cli@latest init
227
231
  This includes adding code for updates, building, uploading your app, and verifying update functionality.
228
232
  Capgo bundles are web assets and can be fetched by anyone who knows the URL. Use encryption for banking, regulated, or other high-security apps.
229
233
  During the iOS run-on-device step, choose a physical iPhone/iPad or simulator. If you choose a physical device, the CLI lets you connect, unlock, and check again before it launches the app.
234
+ If the selected Xcode uses Device Hub and Capacitor's native-run cannot open it, onboarding gives you a manual launch path. Run npx cap open ios, select the simulator in Xcode, choose Product > Run, and confirm that the baseline app opens before continuing. MCP live-update onboarding gives the same instructions and waits for deviceRunConfirmed: true. Run npx @capgo/cli@latest doctor for the upstream fix status and upgrade guidance.
230
235
 
231
236
  **Example:**
232
237
 
@@ -264,6 +269,7 @@ If you omit the platform in an interactive terminal, the command asks whether to
264
269
  The command lists available devices and simulators, lets you reload the list, and runs with your selection.
265
270
  For iOS, this asks whether to use a physical iPhone/iPad or simulator before showing devices.
266
271
  Use --no-launch to print the resolved command without starting the app.
272
+ When the selected Xcode uses Device Hub and Capacitor's native-run lacks support, simulator selection prints instructions to run the app from Xcode with npx cap open ios and Product > Run. It does not attempt the incompatible simulator command. Physical-device selection remains available in interactive mode. Run npx @capgo/cli@latest doctor for the upstream fix status and upgrade guidance.
267
273
 
268
274
  **Example:**
269
275
 
@@ -314,6 +320,9 @@ npx @capgo/cli@latest doctor
314
320
 
315
321
  👨‍⚕️ Check if your Capgo app installation is up-to-date and gather information useful for bug reports.
316
322
  This command helps diagnose issues with your setup.
323
+ For local iOS projects on macOS, doctor also checks whether the selected Xcode uses Device Hub and whether the native-run resolved by your app's @capacitor/cli supports it. An incompatible version fails diagnostics with manual launch instructions. Installing a separate top-level native-run does not necessarily update the copy used by Capacitor.
324
+ Xcode 27 removed Simulator.app. As of October 29, 2026, the Device Hub fix is merged but unreleased, and the latest published native-run is 2.0.3. There is no released minimum Capacitor version for this fix yet, including with Capacitor CLI 8.6.0. See the upstream issue and temporary package-manager patch: https://github.com/ionic-team/capacitor/issues/8620
325
+ Until the fixed dependency is available, use npx cap open ios, select the simulator in Xcode, and choose Product > Run. You can also use a physical device or select an older installed Xcode that includes Simulator.app. After the fix ships, update the dependency used by @capacitor/cli and your lockfile, then run doctor again. Keep the Capacitor packages on the same major version; a major upgrade is not required just to change simulator launching.
317
326
 
318
327
  **Example:**
319
328
 
@@ -2523,6 +2532,61 @@ npx @capgo/cli@latest mcp
2523
2532
  | **--capacitor-config** | <code>string</code> | Capacitor config source to update (useful with dynamic monorepo configs) |
2524
2533
 
2525
2534
 
2535
+ ## <a id="simulator"></a> 🔹 **Simulator**
2536
+
2537
+ Start a cloud simulator. A running simulator uses one builder slot and build minutes.
2538
+
2539
+ ### <a id="simulator-start"></a> 🔹 **Start**
2540
+
2541
+ ```bash
2542
+ npx @capgo/cli@latest simulator start
2543
+ ```
2544
+
2545
+ Start an iOS or Android simulator and print its session URL.
2546
+
2547
+ **Options:**
2548
+
2549
+ | Param | Type | Description |
2550
+ | -------------- | ------------- | -------------------- |
2551
+ | **-p** | <code>string</code> | ios or android |
2552
+ | **-n** | <code>string</code> | Session name |
2553
+ | **--json** | <code>boolean</code> | Print the session JSON |
2554
+ | **-a** | <code>string</code> | API key to link to your account |
2555
+ | **--api-host** | <code>string</code> | Custom Capgo API URL for self-hosting or testing, e.g. https://api.example.com or http://127.0.0.1:8787 (env: CAPGO_API_HOST) |
2556
+
2557
+ ### <a id="simulator-get"></a> 🔹 **Get**
2558
+
2559
+ ```bash
2560
+ npx @capgo/cli@latest simulator get
2561
+ ```
2562
+
2563
+ Read one simulator session.
2564
+
2565
+ **Options:**
2566
+
2567
+ | Param | Type | Description |
2568
+ | -------------- | ------------- | -------------------- |
2569
+ | **--json** | <code>boolean</code> | Print the session JSON |
2570
+ | **-a** | <code>string</code> | API key to link to your account |
2571
+ | **--api-host** | <code>string</code> | Custom Capgo API URL for self-hosting or testing, e.g. https://api.example.com or http://127.0.0.1:8787 (env: CAPGO_API_HOST) |
2572
+
2573
+ ### <a id="simulator-stop"></a> 🔹 **Stop**
2574
+
2575
+ ```bash
2576
+ npx @capgo/cli@latest simulator stop
2577
+ ```
2578
+
2579
+ Stop a simulator session and record its build minutes.
2580
+
2581
+ **Options:**
2582
+
2583
+ | Param | Type | Description |
2584
+ | -------------- | ------------- | -------------------- |
2585
+ | **--json** | <code>boolean</code> | Print the session JSON |
2586
+ | **-a** | <code>string</code> | API key to link to your account |
2587
+ | **--api-host** | <code>string</code> | Custom Capgo API URL for self-hosting or testing, e.g. https://api.example.com or http://127.0.0.1:8787 (env: CAPGO_API_HOST) |
2588
+
2589
+
2526
2590
 
2527
2591
  <!-- AUTO-GENERATED-DOCS-END -->
2528
2592