@capgo/cli 7.93.3 → 7.94.0

package/README.md

@@ -7,14 +7,14 @@
 
 A CLI to upload and download files from the Capgo Cloud.
 
-You can find the most up to date version of this doc in our web doc:
+You can find the most up-to-date version of this doc in our web doc:
 https://capgo.app/docs/cli/overview/
 
 ## Usage
 
 Before using the CLI, you should register here: https://capgo.app/
 
-Then go to your account in `apikey` section and click in the `all` key to copy it.
+Then go to your account in the `apikey` section and click the `all` key to copy it.
 
 Follow the documentation here: https://capacitorjs.com/docs/getting-started/
 
@@ -24,6 +24,8 @@ Follow the documentation here: https://capacitorjs.com/docs/getting-started/
 ## 📋 Table of Contents
 
 - 🚀 [Init](#init)
+- 📱 [Run](#run)
+  - [Device](#run-device)
 - 🔹 [Star](#star)
 - 🔹 [Star-all](#star-all)
 - 👨‍⚕️ [Doctor](#doctor)
@@ -72,7 +74,13 @@ Follow the documentation here: https://capacitorjs.com/docs/getting-started/
   - [Init](#build-init)
   - [Request](#build-request)
   - [Credentials](#build-credentials)
+    - [Save](#build-credentials-save)
+    - [List](#build-credentials-list)
+    - [Clear](#build-credentials-clear)
+    - [Update](#build-credentials-update)
+    - [Migrate](#build-credentials-migrate)
 - 🔹 [Probe](#probe)
+- 🔹 [Generate-docs](#generate-docs)
 - 🔹 [Mcp](#mcp)
 
 ## <a id="init"></a> 🚀 **Init**
@@ -86,6 +94,7 @@ npx @capgo/cli@latest init
 🚀 Initialize a new app in Capgo Cloud with step-by-step guidance.
 This includes adding code for updates, building, uploading your app, and verifying update functionality.
 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.
+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.
 
 **Example:**
 
@@ -93,16 +102,45 @@ Capgo bundles are web assets and can be fetched by anyone who knows the URL. Use
 npx @capgo/cli@latest init YOUR_API_KEY com.example.app
 ```
 
-## <a id="options"></a> Options
+## <a id="options-init"></a> Options (Init)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | App name for display in Capgo Cloud |
-| **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
+| **-n** | <code>string</code> | App name for display in Capgo Cloud |
+| **-i** | <code>string</code> | App icon path for display in Capgo Cloud |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
 
+## <a id="run"></a> 📱 **Run**
+
+📱 Run Capacitor apps on devices from the CLI.
+
+### <a id="run-device"></a> 🔹 **Device**
+
+```bash
+npx @capgo/cli@latest run device
+```
+
+📱 Run your Capacitor app on a connected device or simulator.
+If you omit the platform in an interactive terminal, the command asks whether to start on iOS or Android.
+The command lists available devices and simulators, lets you reload the list, and runs with your selection.
+For iOS, this asks whether to use a physical iPhone/iPad or simulator before showing devices.
+Use --no-launch to print the resolved command without starting the app.
+
+**Example:**
+
+```bash
+npx @capgo/cli@latest run device ios --no-launch
+```
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--no-launch** | <code>boolean</code> | Resolve and print the run command without starting the app |
+
+
 ## <a id="star"></a> 🔹 **Star**
 
 ```bash
@@ -122,7 +160,7 @@ npx @capgo/cli@latest star-all
 ⭐ Star all Capgo GitHub repositories with a small random delay between each request.
 If you do not pass repositories, this defaults to all Cap-go repositories whose name starts with `capacitor-`.
 
-## <a id="options"></a> Options
+## <a id="options-star-all"></a> Options (Star-all)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -146,7 +184,7 @@ This command helps diagnose issues with your setup.
 npx @capgo/cli@latest doctor
 ```
 
-## <a id="options"></a> Options
+## <a id="options-doctor"></a> Options (Doctor)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -170,7 +208,7 @@ Use --apikey=******** in any command to override it.
 npx @capgo/cli@latest login YOUR_API_KEY
 ```
 
-## <a id="options"></a> Options
+## <a id="options-login"></a> Options (Login)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -206,10 +244,10 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-p,** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
-| **-c,** | <code>string</code> | Channel to link to |
-| **-e,** | <code>string</code> | Link to external URL instead of upload to Capgo Cloud |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-p** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
+| **-c** | <code>string</code> | Channel to link to |
+| **-e** | <code>string</code> | Link to external URL instead of upload to Capgo Cloud |
 | **--iv-session-key** | <code>string</code> | Set the IV and session key for bundle URL external |
 | **--s3-region** | <code>string</code> | Region for your S3 bucket |
 | **--s3-apikey** | <code>string</code> | API key for your S3 endpoint |
@@ -224,7 +262,7 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 | **--no-key** | <code>boolean</code> | Ignore signing key and send clear update |
 | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
 | **--display-iv-session** | <code>boolean</code> | Show in the console the IV and session key used to encrypt the update |
-| **-b,** | <code>string</code> | Bundle version number of the bundle to upload |
+| **-b** | <code>string</code> | Bundle version number of the bundle to upload |
 | **--link** | <code>string</code> | Link to external resource (e.g. GitHub release) |
 | **--comment** | <code>string</code> | Comment about this version, could be a release note, a commit hash, a commit message, etc. |
 | **--min-update-version** | <code>string</code> | Minimal version required to update to this version. Used only if the disable auto update is set to metadata in channel |
@@ -239,12 +277,12 @@ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel prod
 | **--tus-chunk-size** | <code>string</code> | Chunk size in bytes for TUS resumable uploads (default: auto) |
 | **--partial** | <code>boolean</code> | [DEPRECATED] Use --delta instead. Upload incremental updates |
 | **--partial-only** | <code>boolean</code> | [DEPRECATED] Use --delta-only instead. Upload only incremental updates, skip full bundle |
-| **--delta** | <code>boolean</code> | Upload delta updates (only changed files) for instant, super fast updates instead of big zip downloads |
+| **--delta** | <code>boolean</code> | Upload delta updates (only changed files) for instant, super-fast updates instead of big zip downloads |
 | **--delta-only** | <code>boolean</code> | Upload only delta updates without full bundle for maximum speed (useful for large apps) |
 | **--no-delta** | <code>boolean</code> | Disable delta updates even if Direct Update is enabled |
 | **--encrypted-checksum** | <code>string</code> | An encrypted checksum (signature). Used only when uploading an external bundle. |
 | **--auto-set-bundle** | <code>boolean</code> | Set the bundle in capacitor.config.json |
-| **--dry-upload** | <code>boolean</code> | Dry upload the bundle process, mean it will not upload the files but add the row in database (Used by Capgo for internal testing) |
+| **--dry-upload** | <code>boolean</code> | Dry upload the bundle process: add the row in database without uploading files or updating channels (Used by Capgo for internal testing) |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
 | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
 | **--encrypt-partial** | <code>boolean</code> | Encrypt delta update files (auto-enabled for updater > 6.14.4) |
@@ -275,8 +313,8 @@ npx @capgo/cli@latest bundle compatibility com.example.app --channel production
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-c,** | <code>string</code> | Channel to check the compatibility with |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-c** | <code>string</code> | Channel to check the compatibility with |
 | **--text** | <code>boolean</code> | Output text instead of emojis |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
 | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
@@ -301,8 +339,8 @@ npx @capgo/cli@latest bundle releaseType com.example.app --channel production
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-c,** | <code>string</code> | Channel to compare against |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-c** | <code>string</code> | Channel to compare against |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
 | **--node-modules** | <code>string</code> | Paths to node_modules directories for monorepos (comma-separated) |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
@@ -328,7 +366,7 @@ npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -352,7 +390,7 @@ npx @capgo/cli@latest bundle list com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -377,10 +415,10 @@ npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-b,** | <code>string</code> | Bundle version number of the app to delete |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-k,** | <code>string</code> | Number of versions to keep |
-| **-f,** | <code>string</code> | Force removal |
+| **-b** | <code>string</code> | Bundle version number of the app to delete |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-k** | <code>string</code> | Number of versions to keep |
+| **-f** | <code>boolean</code> | Force removal |
 | **--ignore-channel** | <code>boolean</code> | Delete bundles even if linked to channels (WARNING: deletes channels too) |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
@@ -406,7 +444,7 @@ npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
 | -------------- | ------------- | -------------------- |
 | **--key** | <code>string</code> | Custom path for private signing key |
 | **--key-data** | <code>string</code> | Private signing key |
-| **-j,** | <code>string</code> | Output in JSON |
+| **-j** | <code>boolean</code> | Output in JSON |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
 
 ### <a id="bundle-decrypt"></a> 🔓 **Decrypt**
@@ -452,10 +490,10 @@ npx @capgo/cli@latest bundle zip com.example.app --path ./dist
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-p,** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
-| **-b,** | <code>string</code> | Bundle version number to name the zip file |
-| **-n,** | <code>string</code> | Name of the zip file |
-| **-j,** | <code>string</code> | Output in JSON |
+| **-p** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
+| **-b** | <code>string</code> | Bundle version number to name the zip file |
+| **-n** | <code>string</code> | Name of the zip file |
+| **-j** | <code>boolean</code> | Output in JSON |
 | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
 | **--key-v2** | <code>boolean</code> | Use encryption v2 |
 | **--package-json** | <code>string</code> | Paths to package.json files for monorepos (comma-separated) |
@@ -486,9 +524,9 @@ npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | App name for display in Capgo Cloud |
-| **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-n** | <code>string</code> | App name for display in Capgo Cloud |
+| **-i** | <code>string</code> | App icon path for display in Capgo Cloud |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -510,7 +548,7 @@ npx @capgo/cli@latest app delete com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -534,7 +572,7 @@ npx @capgo/cli@latest app list
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -557,8 +595,8 @@ npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-d,** | <code>string</code> | The specific device ID to debug |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-d** | <code>string</code> | The specific device ID to debug |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -605,10 +643,10 @@ npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 3
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | App name for display in Capgo Cloud |
-| **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-r,** | <code>string</code> | Days to keep old bundles (0 = infinite, default: 0) |
+| **-n** | <code>string</code> | App name for display in Capgo Cloud |
+| **-i** | <code>string</code> | App icon path for display in Capgo Cloud |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-r** | <code>string</code> | Days to keep old bundles (0 = infinite, default: 0) |
 | **--expose-metadata** | <code>string</code> | Expose bundle metadata (link and comment) to the plugin (true/false, default: false) |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
@@ -638,9 +676,9 @@ npx @capgo/cli@latest channel add production com.example.app --default
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-d,** | <code>string</code> | Set the channel as default |
+| **-d** | <code>boolean</code> | Set the channel as default |
 | **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -664,7 +702,7 @@ npx @capgo/cli@latest channel delete production com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--delete-bundle** | <code>boolean</code> | Delete the bundle associated with the channel |
 | **--success-if-not-found** | <code>boolean</code> | Success if the channel is not found |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
@@ -690,7 +728,7 @@ npx @capgo/cli@latest channel list com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -712,8 +750,8 @@ npx @capgo/cli@latest channel currentBundle production com.example.app
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-c,** | <code>string</code> | Channel to get the current bundle from |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-c** | <code>string</code> | Channel to get the current bundle from |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--quiet** | <code>boolean</code> | Only print the bundle version |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
@@ -739,9 +777,9 @@ npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --st
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
-| **-b,** | <code>string</code> | Bundle version number of the file to set |
-| **-s,** | <code>string</code> | Set the state of the channel, default or normal |
+| **-a** | <code>string</code> | API key to link to your account |
+| **-b** | <code>string</code> | Bundle version number of the file to set |
+| **-s** | <code>string</code> | Set the state of the channel, default or normal |
 | **--latest-remote** | <code>boolean</code> | Get the latest bundle uploaded in capgo cloud and set it to the channel |
 | **--latest** | <code>boolean</code> | Get the latest version key in the package.json to set it to the channel |
 | **--downgrade** | <code>boolean</code> | Allow to downgrade to version under native one |
@@ -790,7 +828,7 @@ npx @capgo/cli@latest key save --key ./path/to/key.pub
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-f,** | <code>string</code> | Force generate a new one |
+| **-f** | <code>boolean</code> | Force generate a new one |
 | **--key** | <code>string</code> | Key path to save in Capacitor config |
 | **--key-data** | <code>string</code> | Key data to save in Capacitor config |
 
@@ -815,7 +853,7 @@ npx @capgo/cli@latest key create
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-f,** | <code>string</code> | Force generate a new one |
+| **-f** | <code>boolean</code> | Force generate a new one |
 
 ### <a id="key-delete_old"></a> 🗑️ **Delete_old**
 
@@ -854,7 +892,7 @@ npx @capgo/cli@latest account id
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 
 
 ## <a id="organization"></a> 🔹 **Organization**
@@ -881,7 +919,7 @@ npx @capgo/cli@latest organization list
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -905,9 +943,9 @@ npx @capgo/cli@latest organization add --name "My Company" --email admin@mycompa
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | Organization name |
-| **-e,** | <code>string</code> | Management email for the organization |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-n** | <code>string</code> | Organization name |
+| **-e** | <code>string</code> | Management email for the organization |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -935,7 +973,7 @@ npx @capgo/cli@latest organization members ORG_ID
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -960,8 +998,8 @@ npx @capgo/cli@latest organization set ORG_ID --name "New Name"
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | Organization name |
-| **-e,** | <code>string</code> | Management email for the organization |
+| **-n** | <code>string</code> | Organization name |
+| **-e** | <code>string</code> | Management email for the organization |
 | **--enforce-2fa** | <code>boolean</code> | Enable 2FA enforcement for all organization members |
 | **--no-enforce-2fa** | <code>boolean</code> | Disable 2FA enforcement for organization |
 | **--password-policy** | <code>boolean</code> | Enable password policy enforcement for organization |
@@ -978,7 +1016,7 @@ npx @capgo/cli@latest organization set ORG_ID --name "New Name"
 | **--max-apikey-expiration-days** | <code>string</code> | Maximum days before API key expiration (1-365, null for no limit) |
 | **--enforce-hashed-api-keys** | <code>boolean</code> | Enforce hashed/secure API keys (key value stored as hash, shown only once) |
 | **--no-enforce-hashed-api-keys** | <code>boolean</code> | Allow plain-text API keys |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1003,7 +1041,7 @@ npx @capgo/cli@latest organization delete ORG_ID
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1026,7 +1064,7 @@ npx @capgo/cli@latest organisation list
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1044,9 +1082,9 @@ npx @capgo/cli@latest organisation add
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | Organization name |
-| **-e,** | <code>string</code> | Management email for the organization |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-n** | <code>string</code> | Organization name |
+| **-e** | <code>string</code> | Management email for the organization |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1064,8 +1102,8 @@ npx @capgo/cli@latest organisation set
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-n,** | <code>string</code> | Organization name |
-| **-e,** | <code>string</code> | Management email for the organization |
+| **-n** | <code>string</code> | Organization name |
+| **-e** | <code>string</code> | Management email for the organization |
 | **--enforce-2fa** | <code>boolean</code> | Enable 2FA enforcement for all organization members |
 | **--no-enforce-2fa** | <code>boolean</code> | Disable 2FA enforcement for organization |
 | **--password-policy** | <code>boolean</code> | Enable password policy enforcement for organization |
@@ -1082,7 +1120,7 @@ npx @capgo/cli@latest organisation set
 | **--max-apikey-expiration-days** | <code>string</code> | Maximum days before API key expiration (1-365, null for no limit) |
 | **--enforce-hashed-api-keys** | <code>boolean</code> | Enforce hashed/secure API keys (key value stored as hash, shown only once) |
 | **--no-enforce-hashed-api-keys** | <code>boolean</code> | Allow plain-text API keys |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1100,7 +1138,7 @@ npx @capgo/cli@latest organisation delete
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 
@@ -1132,7 +1170,7 @@ Set up iOS build credentials interactively (creates certificates and profiles au
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 
 ### <a id="build-request"></a> 🔹 **Request**
 
@@ -1185,17 +1223,13 @@ npx @capgo/cli@latest build request com.example.app --platform ios --path .
 | **--output-retention** | <code>string</code> | Override output link TTL for this build only (1h to 7d). Examples: 1h, 6h, 2d. Precedence: CLI > env > saved credentials |
 | **--skip-build-number-bump** | <code>boolean</code> | Skip automatic build number/version code incrementing. Uses whatever version is already in the project files. |
 | **--no-skip-build-number-bump** | <code>boolean</code> | Override saved credentials to re-enable automatic build number incrementing for this build only. |
-| **-a,** | <code>string</code> | API key to link to your account |
+| **-a** | <code>string</code> | API key to link to your account |
 | **--supa-host** | <code>string</code> | Custom Supabase host URL (for self-hosting or Capgo development) |
 | **--supa-anon** | <code>string</code> | Custom Supabase anon key (for self-hosting) |
 | **--verbose** | <code>boolean</code> | Enable verbose output with detailed logging |
 
 ### <a id="build-credentials"></a> 🔹 **Credentials**
 
-```bash
-npx @capgo/cli@latest build credentials
-```
-
 Manage build credentials stored locally on your machine.
 🔒 SECURITY:
    - Credentials saved to ~/.capgo-credentials/credentials.json (global) or .capgo-credentials.json (local)
@@ -1206,6 +1240,181 @@ Manage build credentials stored locally on your machine.
    iOS setup: https://capgo.app/docs/cli/cloud-build/ios/
    Android setup: https://capgo.app/docs/cli/cloud-build/android/
 
+#### <a id="build-credentials-save"></a> 🔹 **Save**
+
+```bash
+npx @capgo/cli@latest build credentials save
+```
+
+Save build credentials locally for iOS or Android.
+Credentials are stored in:
+  - ~/.capgo-credentials/credentials.json (default, global)
+  - .capgo-credentials.json in project root (with --local flag)
+⚠️  REQUIRED BEFORE BUILDING: You must save credentials before requesting a build.
+🔒 These credentials are NEVER stored on Capgo servers permanently.
+   They are deleted immediately after the build completes.
+📚 Setup guides:
+   iOS: https://capgo.app/docs/cli/cloud-build/ios/
+   Android: https://capgo.app/docs/cli/cloud-build/android/
+  npx @capgo/cli build credentials save --platform ios \
+    --certificate ./cert.p12 --p12-password "password" \
+    --ios-provisioning-profile ./profile.mobileprovision \
+    --apple-key ./AuthKey.p8 --apple-key-id "KEY123" \
+    --apple-issuer-id "issuer-uuid" --apple-team-id "team-id"
+Multi-target Example (app + widget extension):
+  npx @capgo/cli build credentials save --platform ios \
+    --ios-provisioning-profile ./App.mobileprovision \
+    --ios-provisioning-profile com.example.widget=./Widget.mobileprovision \
+    ...
+  npx @capgo/cli build credentials save --platform android \
+    --keystore ./release.keystore --keystore-alias "my-key" \
+    --keystore-key-password "key-pass" \
+    --play-config ./service-account.json
+Local storage (per-project):
+  npx @capgo/cli build credentials save --local --platform ios ...
+
+**Example:**
+
+```bash
+iOS Example:
+```
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--appId** | <code>string</code> | App ID (e.g., com.example.app) (required) |
+| **--platform** | <code>string</code> | Platform: ios or android (required) |
+| **--certificate** | <code>string</code> | iOS: Path to .p12 certificate file |
+| **--ios-provisioning-profile** | <code>string</code> | iOS: Provisioning profile path or bundleId=path (repeatable) |
+| **--p12-password** | <code>string</code> | iOS: Certificate password (optional if cert has no password) |
+| **--apple-key** | <code>string</code> | iOS: Path to .p8 App Store Connect API key |
+| **--apple-key-id** | <code>string</code> | iOS: App Store Connect API Key ID |
+| **--apple-issuer-id** | <code>string</code> | iOS: App Store Connect Issuer ID |
+| **--apple-team-id** | <code>string</code> | iOS: App Store Connect Team ID |
+| **--ios-distribution** | <code>string</code> | iOS: Distribution mode |
+| **--apple-id** | <code>string</code> | iOS: Apple ID email (optional) |
+| **--apple-app-password** | <code>string</code> | iOS: App-specific password (optional) |
+| **--keystore** | <code>string</code> | Android: Path to keystore file (.keystore or .jks) |
+| **--keystore-alias** | <code>string</code> | Android: Keystore key alias |
+| **--keystore-key-password** | <code>string</code> | Android: Keystore key password |
+| **--keystore-store-password** | <code>string</code> | Android: Keystore store password |
+| **--play-config** | <code>string</code> | Android: Path to Play Store service account JSON |
+| **--android-flavor** | <code>string</code> | Android: Product flavor to build (e.g. production). Required if your project has multiple flavors. |
+| **--local** | <code>boolean</code> | Save to .capgo-credentials.json in project root instead of global ~/.capgo-credentials/ |
+| **--output-upload** | <code>boolean</code> | Upload build outputs (IPA/APK/AAB) to Capgo storage and print download links |
+| **--no-output-upload** | <code>boolean</code> | Do not upload build outputs (IPA/APK/AAB) to Capgo storage |
+| **--output-retention** | <code>string</code> | Output link TTL: 1h to 7d (default: 1h). Examples: 1h, 6h, 2d |
+| **--skip-build-number-bump** | <code>boolean</code> | Skip automatic build number/version code incrementing on future builds |
+| **--no-skip-build-number-bump** | <code>boolean</code> | Re-enable automatic build number incrementing (default behavior) |
+
+#### <a id="build-credentials-list"></a> 📋 **List**
+
+```bash
+npx @capgo/cli@latest build credentials list
+```
+
+List saved build credentials (passwords masked).
+Shows what credentials are currently saved (both global and local).
+Examples:
+  npx @capgo/cli build credentials list  # List all apps
+  npx @capgo/cli build credentials list --appId com.example.app  # List specific app
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--appId** | <code>string</code> | App ID to list (optional, lists all if omitted) |
+| **--local** | <code>boolean</code> | List credentials from local .capgo-credentials.json only |
+
+#### <a id="build-credentials-clear"></a> 🔹 **Clear**
+
+```bash
+npx @capgo/cli@latest build credentials clear
+```
+
+Clear saved build credentials.
+Remove credentials from storage.
+Use --appId and --platform to target specific credentials.
+Examples:
+  npx @capgo/cli build credentials clear  # Clear all apps (global)
+  npx @capgo/cli build credentials clear --local  # Clear local credentials
+  npx @capgo/cli build credentials clear --appId com.example.app --platform ios
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--appId** | <code>string</code> | App ID to clear (optional, clears all apps if omitted) |
+| **--platform** | <code>string</code> | Platform to clear: ios or android (optional, clears all platforms if omitted) |
+| **--local** | <code>boolean</code> | Clear from local .capgo-credentials.json instead of global |
+
+#### <a id="build-credentials-update"></a> 🔹 **Update**
+
+```bash
+npx @capgo/cli@latest build credentials update
+```
+
+Update specific credentials without providing all of them again.
+Update existing credentials by providing only the fields you want to change.
+Platform is auto-detected from the options you provide.
+Examples:
+  npx @capgo/cli build credentials update --ios-provisioning-profile ./new-profile.mobileprovision
+  npx @capgo/cli build credentials update --local --keystore ./new-keystore.jks
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--appId** | <code>string</code> | App ID (auto-detected from capacitor.config if omitted) |
+| **--platform** | <code>string</code> | Platform: ios or android (auto-detected from options) |
+| **--local** | <code>boolean</code> | Update local .capgo-credentials.json instead of global |
+| **--certificate** | <code>string</code> | Path to P12 certificate file |
+| **--ios-provisioning-profile** | <code>string</code> | Provisioning profile path or bundleId=path (repeatable, additive by default) |
+| **--overwrite-ios-provisioning-map** | <code>boolean</code> | Replace the entire provisioning map instead of merging (default: merge) |
+| **--p12-password** | <code>string</code> | P12 certificate password |
+| **--apple-key** | <code>string</code> | Path to App Store Connect API key (.p8 file) |
+| **--apple-key-id** | <code>string</code> | App Store Connect API Key ID |
+| **--apple-issuer-id** | <code>string</code> | App Store Connect Issuer ID |
+| **--apple-team-id** | <code>string</code> | App Store Connect Team ID |
+| **--ios-distribution** | <code>string</code> | iOS: Distribution mode |
+| **--keystore** | <code>string</code> | Path to keystore file (.keystore or .jks) |
+| **--keystore-alias** | <code>string</code> | Keystore key alias |
+| **--keystore-key-password** | <code>string</code> | Keystore key password |
+| **--keystore-store-password** | <code>string</code> | Keystore store password |
+| **--play-config** | <code>string</code> | Path to Google Play service account JSON |
+| **--android-flavor** | <code>string</code> | Android: Product flavor to build (e.g. production). Required if your project has multiple flavors. |
+| **--output-upload** | <code>boolean</code> | Upload build outputs (IPA/APK/AAB) to Capgo storage and print download links |
+| **--no-output-upload** | <code>boolean</code> | Do not upload build outputs (IPA/APK/AAB) to Capgo storage |
+| **--output-retention** | <code>string</code> | Output link TTL: 1h to 7d. Examples: 1h, 6h, 2d |
+| **--skip-build-number-bump** | <code>boolean</code> | Skip automatic build number/version code incrementing on future builds |
+| **--no-skip-build-number-bump** | <code>boolean</code> | Re-enable automatic build number incrementing (default behavior) |
+
+#### <a id="build-credentials-migrate"></a> 🔹 **Migrate**
+
+```bash
+npx @capgo/cli@latest build credentials migrate
+```
+
+Migrate legacy provisioning profile to the new multi-target format.
+Converts BUILD_PROVISION_PROFILE_BASE64 to CAPGO_IOS_PROVISIONING_MAP.
+Discovers the main bundle ID from your Xcode project automatically.
+  npx @capgo/cli build credentials migrate --platform ios
+
+**Example:**
+
+```bash
+Example:
+```
+
+**Options:**
+
+| Param          | Type          | Description          |
+| -------------- | ------------- | -------------------- |
+| **--appId** | <code>string</code> | App ID (auto-detected from capacitor.config if omitted) |
+| **--platform** | <code>string</code> | Platform (only ios is supported) |
+| **--local** | <code>boolean</code> | Migrate from local .capgo-credentials.json instead of global |
+
 
 ## <a id="probe"></a> 🔹 **Probe**
 
@@ -1223,7 +1432,7 @@ and reports whether an update would be delivered, or explains why not.
 npx @capgo/cli@latest probe --platform ios
 ```
 
-## <a id="options"></a> Options
+## <a id="options-probe"></a> Options (Probe)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |