@capgo/cli 8.90.0 → 8.90.2

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.
Files changed (75) hide show
  1. package/README.md +92 -92
  2. package/dist/index.js +1080 -1027
  3. package/dist/notify-app-ready-worker.js +201 -207
  4. package/dist/onboarding-worker.js +472 -473
  5. package/dist/package.json +19 -23
  6. package/dist/src/analytics/api-perf.d.ts +39 -0
  7. package/dist/src/analytics/cli-headers.d.ts +0 -1
  8. package/dist/src/analytics/error-category.d.ts +1 -1
  9. package/dist/src/analytics/org-resolver.d.ts +2 -6
  10. package/dist/src/analytics/track.d.ts +1 -3
  11. package/dist/src/api/app.d.ts +31 -19
  12. package/dist/src/api/channels.d.ts +25 -52
  13. package/dist/src/api/cli-data.d.ts +27 -0
  14. package/dist/src/api/http-error.d.ts +9 -0
  15. package/dist/src/api/preflight.d.ts +53 -0
  16. package/dist/src/api/versions.d.ts +15 -59
  17. package/dist/src/app/add.d.ts +5 -9
  18. package/dist/src/app/debug.d.ts +1 -2
  19. package/dist/src/app/default-channels.d.ts +7 -9
  20. package/dist/src/app/list.d.ts +3 -70
  21. package/dist/src/auth/session.d.ts +1 -2
  22. package/dist/src/build/onboarding/android/ui/app.d.ts +2 -3
  23. package/dist/src/build/onboarding/app-selection.d.ts +2 -4
  24. package/dist/src/build/onboarding/appflow/tail.d.ts +1 -1
  25. package/dist/src/build/onboarding/command.d.ts +2 -3
  26. package/dist/src/build/onboarding/login.d.ts +1 -2
  27. package/dist/src/build/onboarding/ui/app.d.ts +2 -3
  28. package/dist/src/build/onboarding/ui/appflow-app.d.ts +1 -1
  29. package/dist/src/build/onboarding/ui/shell.d.ts +2 -3
  30. package/dist/src/build/prescan/command.d.ts +1 -2
  31. package/dist/src/build/prescan/context.d.ts +2 -3
  32. package/dist/src/build/prescan/types.d.ts +3 -4
  33. package/dist/src/bundle/auto-bump-ai.d.ts +6 -9
  34. package/dist/src/bundle/finalize-upload.d.ts +2 -4
  35. package/dist/src/bundle/list.d.ts +1 -25
  36. package/dist/src/bundle/manifest-upload.d.ts +1 -1
  37. package/dist/src/bundle/unlink.d.ts +1 -2
  38. package/dist/src/bundle/upload.d.ts +3 -3
  39. package/dist/src/channel/add.d.ts +3 -4
  40. package/dist/src/init/builder-setup.d.ts +1 -1
  41. package/dist/src/init/channel-selection.d.ts +2 -3
  42. package/dist/src/init/onboarding-report.d.ts +2 -4
  43. package/dist/src/init/replay.d.ts +2 -3
  44. package/dist/src/login.d.ts +1 -2
  45. package/dist/src/mcp/tool-schemas.d.ts +5 -5
  46. package/dist/src/observe/command.d.ts +1 -2
  47. package/dist/src/onboarding/background-api.d.ts +1 -1
  48. package/dist/src/onboarding/background-check.d.ts +0 -1
  49. package/dist/src/onboarding/background.d.ts +1 -2
  50. package/dist/src/organization/add.d.ts +2 -24
  51. package/dist/src/organization/list.d.ts +4 -34
  52. package/dist/src/organization/set.d.ts +4 -6
  53. package/dist/src/preview/qr.d.ts +1 -2
  54. package/dist/src/recovery/app-id.d.ts +1 -2
  55. package/dist/src/schemas/account.d.ts +2 -2
  56. package/dist/src/schemas/app.d.ts +6 -6
  57. package/dist/src/schemas/base.d.ts +2 -2
  58. package/dist/src/schemas/build.d.ts +4 -4
  59. package/dist/src/schemas/bundle.d.ts +13 -13
  60. package/dist/src/schemas/channel.d.ts +10 -10
  61. package/dist/src/schemas/onboarding.d.ts +1 -1
  62. package/dist/src/schemas/organization.d.ts +8 -8
  63. package/dist/src/schemas/sdk.d.ts +52 -52
  64. package/dist/src/sdk.d.ts +19 -8
  65. package/dist/src/sdk.js +449 -484
  66. package/dist/src/shared/network-error.d.ts +2 -2
  67. package/dist/src/shared/two-factor-compliance.d.ts +1 -1
  68. package/dist/src/types/api.d.ts +214 -0
  69. package/dist/src/user/whoami.d.ts +3 -4
  70. package/dist/src/utils.d.ts +135 -10894
  71. package/dist/updater-installed-worker.js +183 -189
  72. package/package.json +19 -23
  73. package/skills/usage/SKILL.md +2 -2
  74. package/dist/src/analytics/supabase-perf.d.ts +0 -48
  75. package/dist/src/types/supabase.types.d.ts +0 -5588
package/README.md CHANGED
@@ -36,7 +36,7 @@ teams that want Capgo controlled from CI.
36
36
 
37
37
  ## Features
38
38
 
39
- - ☁️ Cloud / Self hosted Support: Use [Capgo Cloud](https://capgo.app/) or your own Supabase backend.
39
+ - ☁️ Cloud / Self hosted Support: Use [Capgo Cloud](https://capgo.app/) or your own Capgo backend.
40
40
  - 🚀 Guided Setup: Initialize a Capacitor app and verify live updates end to end.
41
41
  - 📦 Bundle Management: Upload, list, delete, encrypt, decrypt, and clean bundles.
42
42
  - 📺 Channel Support: Assign bundles to release channels and manage rollout tracks.
@@ -53,7 +53,7 @@ teams that want Capgo controlled from CI.
53
53
  You have 3 ways possible:
54
54
 
55
55
  - Use [capgo.app](https://capgo.app) for a full featured live-update system with setup, upload, channels, rollback, stats, and cloud builds.
56
- - Use your own self-hosted backend with `--supa-host` and `--supa-anon` on supported commands.
56
+ - Use your own self-hosted backend with `--api-host` on supported commands (or `localApi` in capacitor config).
57
57
  - Use the CLI programmatically through the SDK or MCP server for custom release automation.
58
58
 
59
59
  ## Quick Start
@@ -237,8 +237,8 @@ npx @capgo/cli@latest init YOUR_API_KEY com.example.app
237
237
  | **-a** | <code>string</code> | API key to link to your account |
238
238
  | **-n** | <code>string</code> | App name for display in Capgo Cloud |
239
239
  | **-i** | <code>string</code> | App icon path for display in Capgo Cloud |
240
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
241
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
240
+ | **--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) |
241
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
242
242
  | **--package-json** | <code>string</code> | Package JSON for the Capacitor app to onboard (useful in monorepos) |
243
243
  | **--main-file** | <code>string</code> | Application entry file to update (useful in monorepos) |
244
244
  | **--capacitor-config** | <code>string</code> | Capacitor config source to update (useful with dynamic monorepo configs) |
@@ -347,8 +347,8 @@ npx @capgo/cli@latest login YOUR_API_KEY
347
347
  | -------------- | ------------- | -------------------- |
348
348
  | **-a** | <code>string</code> | API key to link to your account |
349
349
  | **--local** | <code>boolean</code> | Only save in local folder, git ignored for security. |
350
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
351
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
350
+ | **--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) |
351
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
352
352
 
353
353
 
354
354
  ## <a id="get-qr"></a> 🔹 **Get-qr**
@@ -377,8 +377,8 @@ Examples:
377
377
  | **--url** | <code>boolean</code> | Print preview URLs only (web and deep link), without a terminal QR code |
378
378
  | **--web-url** | <code>boolean</code> | Encode the web preview URL in the QR code and PNG instead of the capgo:// deep link |
379
379
  | **--preview-env** | <code>string</code> | Preview web URL environment |
380
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
381
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
380
+ | **--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) |
381
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
382
382
 
383
383
 
384
384
  ## <a id="bundle"></a> 📦 **Bundle**
@@ -470,8 +470,8 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
470
470
  | **--self-assign** | <code>boolean</code> | Allow devices to auto-join this channel (updates channel setting) |
471
471
  | **--qr-preview** | <code>boolean</code> | Print a terminal QR code for this bundle preview after upload |
472
472
  | **--send-update-notification** | <code>boolean</code> | Send a native update-check notification to devices after updating linked channel bundles |
473
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
474
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
473
+ | **--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) |
474
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
475
475
  | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
476
476
 
477
477
  ### <a id="bundle-compatibility"></a> 🧪 **Compatibility**
@@ -497,8 +497,8 @@ npx @capgo/cli@latest bundle compatibility com.example.app --channel production
497
497
  | **--text** | <code>boolean</code> | Output text instead of emojis |
498
498
  | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
499
499
  | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
500
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
501
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
500
+ | **--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) |
501
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
502
502
 
503
503
  ### <a id="bundle-releaseType"></a> 🔹 **ReleaseType**
504
504
 
@@ -522,8 +522,8 @@ npx @capgo/cli@latest bundle releaseType com.example.app --channel production
522
522
  | **-c** | <code>string</code> | Channel to compare against |
523
523
  | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
524
524
  | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
525
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
526
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
525
+ | **--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) |
526
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
527
527
 
528
528
  ### <a id="bundle-delete"></a> 🗑️ **Delete**
529
529
 
@@ -546,8 +546,8 @@ npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app
546
546
  | Param | Type | Description |
547
547
  | -------------- | ------------- | -------------------- |
548
548
  | **-a** | <code>string</code> | API key to link to your account |
549
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
550
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
549
+ | **--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) |
550
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
551
551
 
552
552
  ### <a id="bundle-list"></a> 📋 **List**
553
553
 
@@ -570,8 +570,8 @@ npx @capgo/cli@latest bundle list com.example.app
570
570
  | Param | Type | Description |
571
571
  | -------------- | ------------- | -------------------- |
572
572
  | **-a** | <code>string</code> | API key to link to your account |
573
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
574
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
573
+ | **--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) |
574
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
575
575
 
576
576
  ### <a id="bundle-cleanup"></a> 🧹 **Cleanup**
577
577
 
@@ -599,8 +599,8 @@ npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3
599
599
  | **-k** | <code>string</code> | Number of versions to keep |
600
600
  | **-f** | <code>boolean</code> | Force removal |
601
601
  | **--ignore-channel** | <code>boolean</code> | Delete bundles even if linked to channels (WARNING: deletes channels too) |
602
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
603
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
602
+ | **--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) |
603
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
604
604
 
605
605
  ### <a id="bundle-encrypt"></a> 🔒 **Encrypt**
606
606
 
@@ -707,8 +707,8 @@ npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png
707
707
  | **-n** | <code>string</code> | App name for display in Capgo Cloud |
708
708
  | **-i** | <code>string</code> | App icon path for display in Capgo Cloud |
709
709
  | **-a** | <code>string</code> | API key to link to your account |
710
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
711
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
710
+ | **--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) |
711
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
712
712
 
713
713
  ### <a id="app-delete"></a> 🗑️ **Delete**
714
714
 
@@ -729,8 +729,8 @@ npx @capgo/cli@latest app delete com.example.app
729
729
  | Param | Type | Description |
730
730
  | -------------- | ------------- | -------------------- |
731
731
  | **-a** | <code>string</code> | API key to link to your account |
732
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
733
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
732
+ | **--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) |
733
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
734
734
 
735
735
  ### <a id="app-list"></a> 📋 **List**
736
736
 
@@ -757,8 +757,8 @@ npx @capgo/cli@latest app list
757
757
  | **--show-org** | <code>boolean</code> | Show the organization name for each app |
758
758
  | **--show-org-id** | <code>boolean</code> | Show the organization ID for each app |
759
759
  | **--output-text** | <code>boolean</code> | Print plain text with a CSV app table and no interactive formatting |
760
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
761
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
760
+ | **--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) |
761
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
762
762
 
763
763
  ### <a id="app-todo"></a> 🔹 **Todo**
764
764
 
@@ -784,8 +784,8 @@ npx @capgo/cli@latest app todo com.example.app
784
784
  | -------------- | ------------- | -------------------- |
785
785
  | **--list** | <code>string</code> | Show one todo list and exit; required for dual checklists in non-interactive mode |
786
786
  | **-a** | <code>string</code> | API key to link to your account |
787
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
788
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
787
+ | **--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) |
788
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
789
789
 
790
790
  ### <a id="app-debug"></a> 🐞 **Debug**
791
791
 
@@ -808,8 +808,8 @@ npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID
808
808
  | -------------- | ------------- | -------------------- |
809
809
  | **-a** | <code>string</code> | API key to link to your account |
810
810
  | **-d** | <code>string</code> | The specific device ID to debug |
811
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
812
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
811
+ | **--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) |
812
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
813
813
 
814
814
  ### <a id="app-setting"></a> ⚙️ **Setting**
815
815
 
@@ -888,8 +888,8 @@ npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 3
888
888
  | **--default-upload-channel** | <code>string</code> | Default upload channel name for this app |
889
889
  | **--default-download-channel** | <code>string</code> | Default download channel name for this app (sets channel public=true) |
890
890
  | **--disable-download-channels** | <code>boolean</code> | Disable Capgo download channels for this app (sets all channels public=false) |
891
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
892
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
891
+ | **--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) |
892
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
893
893
 
894
894
 
895
895
  ## <a id="channel"></a> 📢 **Channel**
@@ -919,8 +919,8 @@ npx @capgo/cli@latest channel add production com.example.app --default
919
919
  | **-d** | <code>boolean</code> | Set the channel as default |
920
920
  | **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel |
921
921
  | **-a** | <code>string</code> | API key to link to your account |
922
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
923
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
922
+ | **--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) |
923
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
924
924
 
925
925
  ### <a id="channel-delete"></a> 🗑️ **Delete**
926
926
 
@@ -945,8 +945,8 @@ npx @capgo/cli@latest channel delete production com.example.app
945
945
  | **-a** | <code>string</code> | API key to link to your account |
946
946
  | **--delete-bundle** | <code>boolean</code> | Delete the bundle associated with the channel |
947
947
  | **--success-if-not-found** | <code>boolean</code> | Success if the channel is not found |
948
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
949
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
948
+ | **--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) |
949
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
950
950
 
951
951
  ### <a id="channel-list"></a> 📋 **List**
952
952
 
@@ -969,8 +969,8 @@ npx @capgo/cli@latest channel list com.example.app
969
969
  | Param | Type | Description |
970
970
  | -------------- | ------------- | -------------------- |
971
971
  | **-a** | <code>string</code> | API key to link to your account |
972
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
973
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
972
+ | **--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) |
973
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
974
974
 
975
975
  ### <a id="channel-currentBundle"></a> 📦 **CurrentBundle**
976
976
 
@@ -993,8 +993,8 @@ npx @capgo/cli@latest channel currentBundle production com.example.app
993
993
  | **-c** | <code>string</code> | Channel to get the current bundle from |
994
994
  | **-a** | <code>string</code> | API key to link to your account |
995
995
  | **--quiet** | <code>boolean</code> | Only print the bundle version |
996
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
997
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
996
+ | **--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) |
997
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
998
998
 
999
999
  ### <a id="channel-promote"></a> 🚀 **Promote**
1000
1000
 
@@ -1019,8 +1019,8 @@ npx @capgo/cli@latest channel promote staging production com.example.app
1019
1019
  | **--send-update-notification** | <code>boolean</code> | Send a native update-check notification to devices after updating the linked channel bundle |
1020
1020
  | **--ignore-metadata-check** | <code>boolean</code> | Ignore checking node_modules compatibility if present in the bundle |
1021
1021
  | **--accept-incompatible** | <code>boolean</code> | Accept native-package incompatibility as handled (still checks and warns, sets the channel instead of failing). Use this when your app already guards missing plugins at runtime. Cannot be combined with --ignore-metadata-check. |
1022
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1023
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1022
+ | **--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) |
1023
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1024
1024
 
1025
1025
  ### <a id="channel-set"></a> ⚙️ **Set**
1026
1026
 
@@ -1094,8 +1094,8 @@ npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --st
1094
1094
  | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
1095
1095
  | **--ignore-metadata-check** | <code>boolean</code> | Ignore checking node_modules compatibility if present in the bundle |
1096
1096
  | **--accept-incompatible** | <code>boolean</code> | Accept native-package incompatibility as handled (still checks and warns, sets the channel instead of failing). Use this when your app already guards missing plugins at runtime. Cannot be combined with --ignore-metadata-check. |
1097
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1098
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1097
+ | **--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) |
1098
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1099
1099
 
1100
1100
 
1101
1101
  ## <a id="key"></a> 🔐 **Key**
@@ -1219,8 +1219,8 @@ npx @capgo/cli@latest account get
1219
1219
  | Param | Type | Description |
1220
1220
  | -------------- | ------------- | -------------------- |
1221
1221
  | **-a** | <code>string</code> | API key to link to your account |
1222
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1223
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1222
+ | **--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) |
1223
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1224
1224
 
1225
1225
  ### <a id="account-set"></a> ⚙️ **Set**
1226
1226
 
@@ -1254,8 +1254,8 @@ npx @capgo/cli@latest account set --first-name Ada --last-name Lovelace
1254
1254
  | **--no-newsletter** | <code>boolean</code> | Unsubscribe from the newsletter |
1255
1255
  | **--email-preference** | <code>string</code> | Email notification toggle (repeatable), e.g. --email-preference weekly_stats=false. Keys: usage_limit, credit_usage, bundle_created, bundle_deployed, deploy_stats_24h, weekly_stats, monthly_stats, billing_period_stats, device_error, channel_self_rejected, onboarding, builder_onboarding, bundle_incompatible, cli_realtime_feed |
1256
1256
  | **-a** | <code>string</code> | API key to link to your account |
1257
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1258
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1257
+ | **--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) |
1258
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1259
1259
 
1260
1260
 
1261
1261
  ## <a id="organization"></a> 🔹 **Organization**
@@ -1283,8 +1283,8 @@ npx @capgo/cli@latest organization list
1283
1283
  | Param | Type | Description |
1284
1284
  | -------------- | ------------- | -------------------- |
1285
1285
  | **-a** | <code>string</code> | API key to link to your account |
1286
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1287
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1286
+ | **--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) |
1287
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1288
1288
 
1289
1289
  ### <a id="organization-add"></a> ➕ **Add**
1290
1290
 
@@ -1309,8 +1309,8 @@ npx @capgo/cli@latest organization add --name "My Company" --email admin@mycompa
1309
1309
  | **-n** | <code>string</code> | Organization name |
1310
1310
  | **-e** | <code>string</code> | Management email for the organization |
1311
1311
  | **-a** | <code>string</code> | API key to link to your account |
1312
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1313
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1312
+ | **--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) |
1313
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1314
1314
 
1315
1315
  ### <a id="organization-members"></a> 🔹 **Members**
1316
1316
 
@@ -1337,8 +1337,8 @@ npx @capgo/cli@latest organization members ORG_ID
1337
1337
  | Param | Type | Description |
1338
1338
  | -------------- | ------------- | -------------------- |
1339
1339
  | **-a** | <code>string</code> | API key to link to your account |
1340
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1341
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1340
+ | **--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) |
1341
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1342
1342
 
1343
1343
  ### <a id="organization-members-invite"></a> 🔹 **Members-invite**
1344
1344
 
@@ -1361,8 +1361,8 @@ npx @capgo/cli@latest organization members-invite ORG_ID --email teammate@exampl
1361
1361
  | **-e** | <code>string</code> | Email of the user to invite |
1362
1362
  | **-r** | <code>string</code> | Role: org_member, org_billing_admin, org_admin or org_super_admin |
1363
1363
  | **-a** | <code>string</code> | API key to link to your account |
1364
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1365
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1364
+ | **--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) |
1365
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1366
1366
 
1367
1367
  ### <a id="organization-members-role"></a> 🔹 **Members-role**
1368
1368
 
@@ -1385,8 +1385,8 @@ npx @capgo/cli@latest organization members-role ORG_ID --email teammate@example.
1385
1385
  | **-e** | <code>string</code> | Email of the member |
1386
1386
  | **-r** | <code>string</code> | Role: org_member, org_billing_admin, org_admin or org_super_admin |
1387
1387
  | **-a** | <code>string</code> | API key to link to your account |
1388
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1389
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1388
+ | **--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) |
1389
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1390
1390
 
1391
1391
  ### <a id="organization-members-remove"></a> 🔹 **Members-remove**
1392
1392
 
@@ -1408,8 +1408,8 @@ npx @capgo/cli@latest organization members-remove ORG_ID --email teammate@exampl
1408
1408
  | -------------- | ------------- | -------------------- |
1409
1409
  | **-e** | <code>string</code> | Email of the member to remove |
1410
1410
  | **-a** | <code>string</code> | API key to link to your account |
1411
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1412
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1411
+ | **--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) |
1412
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1413
1413
 
1414
1414
  ### <a id="organization-set"></a> ⚙️ **Set**
1415
1415
 
@@ -1456,8 +1456,8 @@ npx @capgo/cli@latest organization set ORG_ID --name "New Name"
1456
1456
  | **--required-encryption-key** | <code>string</code> | Only accept bundles encrypted with this public key fingerprint (null to clear) |
1457
1457
  | **--email-preference** | <code>string</code> | Organization email notification toggle (repeatable), e.g. --email-preference weekly_stats=false. Keys: usage_limit, credit_usage, bundle_created, bundle_deployed, deploy_stats_24h, weekly_stats, monthly_stats, billing_period_stats, device_error, channel_self_rejected, onboarding, builder_onboarding |
1458
1458
  | **-a** | <code>string</code> | API key to link to your account |
1459
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1460
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1459
+ | **--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) |
1460
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1461
1461
 
1462
1462
  ### <a id="organization-delete"></a> 🗑️ **Delete**
1463
1463
 
@@ -1481,8 +1481,8 @@ npx @capgo/cli@latest organization delete ORG_ID
1481
1481
  | Param | Type | Description |
1482
1482
  | -------------- | ------------- | -------------------- |
1483
1483
  | **-a** | <code>string</code> | API key to link to your account |
1484
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1485
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1484
+ | **--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) |
1485
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1486
1486
 
1487
1487
 
1488
1488
  ## <a id="organisation"></a> 🔹 **Organisation**
@@ -1504,8 +1504,8 @@ npx @capgo/cli@latest organisation list
1504
1504
  | Param | Type | Description |
1505
1505
  | -------------- | ------------- | -------------------- |
1506
1506
  | **-a** | <code>string</code> | API key to link to your account |
1507
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1508
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1507
+ | **--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) |
1508
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1509
1509
 
1510
1510
  ### <a id="organisation-add"></a> ➕ **Add**
1511
1511
 
@@ -1524,8 +1524,8 @@ npx @capgo/cli@latest organisation add
1524
1524
  | **-n** | <code>string</code> | Organization name |
1525
1525
  | **-e** | <code>string</code> | Management email for the organization |
1526
1526
  | **-a** | <code>string</code> | API key to link to your account |
1527
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1528
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1527
+ | **--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) |
1528
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1529
1529
 
1530
1530
  ### <a id="organisation-set"></a> ⚙️ **Set**
1531
1531
 
@@ -1565,8 +1565,8 @@ npx @capgo/cli@latest organisation set
1565
1565
  | **--required-encryption-key** | <code>string</code> | Only accept bundles encrypted with this public key fingerprint (null to clear) |
1566
1566
  | **--email-preference** | <code>string</code> | Organization email notification toggle (repeatable), e.g. --email-preference weekly_stats=false. Keys: usage_limit, credit_usage, bundle_created, bundle_deployed, deploy_stats_24h, weekly_stats, monthly_stats, billing_period_stats, device_error, channel_self_rejected, onboarding, builder_onboarding |
1567
1567
  | **-a** | <code>string</code> | API key to link to your account |
1568
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1569
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1568
+ | **--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) |
1569
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1570
1570
 
1571
1571
  ### <a id="organisation-delete"></a> 🗑️ **Delete**
1572
1572
 
@@ -1583,8 +1583,8 @@ npx @capgo/cli@latest organisation delete
1583
1583
  | Param | Type | Description |
1584
1584
  | -------------- | ------------- | -------------------- |
1585
1585
  | **-a** | <code>string</code> | API key to link to your account |
1586
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1587
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1586
+ | **--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) |
1587
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1588
1588
 
1589
1589
 
1590
1590
  ## <a id="build"></a> 🔹 **Build**
@@ -1620,8 +1620,8 @@ Example:
1620
1620
  | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
1621
1621
  | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
1622
1622
  | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
1623
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1624
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1623
+ | **--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) |
1624
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1625
1625
 
1626
1626
  ### <a id="build-init"></a> 🚀 **Init**
1627
1627
 
@@ -1639,8 +1639,8 @@ Set up build credentials interactively (iOS: certificates + profiles automated;
1639
1639
  | -------------- | ------------- | -------------------- |
1640
1640
  | **-a** | <code>string</code> | API key to link to your account |
1641
1641
  | **-p** | <code>string</code> | Platform to onboard (ios or android). If omitted, uses the saved platform for Builder-only checklists, then auto-detects a single native folder or prompts. |
1642
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1643
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1642
+ | **--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) |
1643
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1644
1644
  | **--no-analytics** | <code>boolean</code> | Disable build onboarding analytics and terminal replay for this run |
1645
1645
 
1646
1646
  ### <a id="build-request"></a> 🔹 **Request**
@@ -1733,8 +1733,8 @@ Examples:
1733
1733
  | **--send-logs** | <code>boolean</code> | Deprecated alias for --send-logs-to-support |
1734
1734
  | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
1735
1735
  | **-a** | <code>string</code> | API key to link to your account |
1736
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1737
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1736
+ | **--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) |
1737
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1738
1738
 
1739
1739
  ### <a id="build-sync-ios-version"></a> 🔹 **Sync-ios-version**
1740
1740
 
@@ -1791,8 +1791,8 @@ Example:
1791
1791
  | **--skip** | <code>string</code> | Skip specific check(s) by id (repeatable or comma-separated). Alias of --prescan-skip on build request. |
1792
1792
  | **--warn** | <code>string</code> | Downgrade specific check(s) to warning by id (repeatable or comma-separated). Alias of --prescan-warn on build request. |
1793
1793
  | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
1794
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
1795
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
1794
+ | **--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) |
1795
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
1796
1796
 
1797
1797
  ### <a id="build-last-output"></a> 🔹 **Last-output**
1798
1798
 
@@ -2199,8 +2199,8 @@ npx @capgo/cli@latest observe summary
2199
2199
  | **--limit** | <code>string</code> | Max rows to return |
2200
2200
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2201
2201
  | **--json** | <code>boolean</code> | Output as JSON |
2202
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2203
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2202
+ | **--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) |
2203
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2204
2204
 
2205
2205
  ### <a id="observe-metrics"></a> 📊 **Metrics**
2206
2206
 
@@ -2228,8 +2228,8 @@ npx @capgo/cli@latest observe metrics --action app_launch_ready --sort slowest -
2228
2228
  | **--limit** | <code>string</code> | Max rows to return |
2229
2229
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2230
2230
  | **--json** | <code>boolean</code> | Output as JSON |
2231
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2232
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2231
+ | **--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) |
2232
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2233
2233
 
2234
2234
  ### <a id="observe-events"></a> 📊 **Events**
2235
2235
 
@@ -2256,8 +2256,8 @@ npx @capgo/cli@latest observe events --action app_crash_native
2256
2256
  | **--limit** | <code>string</code> | Max rows to return |
2257
2257
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2258
2258
  | **--json** | <code>boolean</code> | Output as JSON |
2259
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2260
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2259
+ | **--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) |
2260
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2261
2261
 
2262
2262
  ### <a id="observe-device"></a> 📱 **Device**
2263
2263
 
@@ -2286,8 +2286,8 @@ npx @capgo/cli@latest observe device DEVICE_ID --json
2286
2286
  | **--limit** | <code>string</code> | Max rows to return |
2287
2287
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2288
2288
  | **--json** | <code>boolean</code> | Output as JSON |
2289
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2290
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2289
+ | **--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) |
2290
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2291
2291
 
2292
2292
  ### <a id="observe-versions"></a> 📊 **Versions**
2293
2293
 
@@ -2314,8 +2314,8 @@ npx @capgo/cli@latest observe versions
2314
2314
  | **--limit** | <code>string</code> | Max rows to return |
2315
2315
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2316
2316
  | **--json** | <code>boolean</code> | Output as JSON |
2317
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2318
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2317
+ | **--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) |
2318
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2319
2319
 
2320
2320
  ### <a id="observe-routes"></a> 📊 **Routes**
2321
2321
 
@@ -2343,8 +2343,8 @@ npx @capgo/cli@latest observe routes --json
2343
2343
  | **--limit** | <code>string</code> | Max rows to return |
2344
2344
  | **--version-name** | <code>string</code> | Filter by bundle version name |
2345
2345
  | **--json** | <code>boolean</code> | Output as JSON |
2346
- | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
2347
- | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
2346
+ | **--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) |
2347
+ | **--files-host** | <code>string</code> | Custom Capgo files API URL when it differs from --api-host (env: CAPGO_FILES_HOST) |
2348
2348
 
2349
2349
 
2350
2350
  ## <a id="mcp"></a> 🔹 **Mcp**