@capgo/cli 8.99.0 → 8.99.3
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 +67 -0
- package/dist/index.js +893 -875
- package/dist/notify-app-ready-worker.js +137 -137
- package/dist/onboarding-worker.js +297 -297
- package/dist/package.json +4 -4
- package/dist/src/analytics/track.d.ts +1 -0
- package/dist/src/app/info.d.ts +3 -0
- package/dist/src/init/command.d.ts +1 -0
- package/dist/src/init/mcp/engine.d.ts +3 -0
- package/dist/src/init/mcp/explanations.d.ts +1 -0
- package/dist/src/init/mcp/live-update-tools.d.ts +2 -0
- package/dist/src/init/upload-recovery.d.ts +2 -2
- package/dist/src/mcp/project-dir.d.ts +10 -6
- package/dist/src/mcp/tool-schemas.d.ts +2 -0
- package/dist/src/run/ios-compatibility.d.ts +19 -0
- package/dist/src/sdk.js +350 -349
- package/dist/src/simulator/session.d.ts +41 -0
- package/dist/src/utils.d.ts +1 -0
- package/dist/updater-installed-worker.js +108 -108
- package/package.json +4 -4
- package/skills/native-builds/SKILL.md +33 -1
- package/skills/release-management/SKILL.md +1 -1
- package/skills/usage/SKILL.md +5 -2
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
|
|
|
@@ -2496,6 +2505,9 @@ Selected tools exposed via MCP:
|
|
|
2496
2505
|
- capgo_search_docs, capgo_set_project_dir
|
|
2497
2506
|
The project directory follows the client's MCP roots (the agent's workspace), so a global
|
|
2498
2507
|
install works from any folder. Clients without roots can call capgo_set_project_dir.
|
|
2508
|
+
Workspace roots with exactly one Capacitor app automatically select that app, including
|
|
2509
|
+
when the server starts there without client roots. Multiple apps require an explicit app path.
|
|
2510
|
+
If @capacitor/core appears missing, select the absolute app folder before installing anything.
|
|
2499
2511
|
Example usage with Claude Desktop:
|
|
2500
2512
|
Add to claude_desktop_config.json:
|
|
2501
2513
|
{
|
|
@@ -2520,6 +2532,61 @@ npx @capgo/cli@latest mcp
|
|
|
2520
2532
|
| **--capacitor-config** | <code>string</code> | Capacitor config source to update (useful with dynamic monorepo configs) |
|
|
2521
2533
|
|
|
2522
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
|
+
|
|
2523
2590
|
|
|
2524
2591
|
<!-- AUTO-GENERATED-DOCS-END -->
|
|
2525
2592
|
|