@capgo/cli 7.93.4 → 7.94.1

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/
 
@@ -74,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**
@@ -96,12 +102,12 @@ During the iOS run-on-device step, choose a physical iPhone/iPad or simulator. I
 npx @capgo/cli@latest init YOUR_API_KEY com.example.app
 ```
 
-### <a id="init-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) |
 
@@ -154,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="star-all-options"></a> Options
+## <a id="options-star-all"></a> Options (Star-all)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -178,7 +184,7 @@ This command helps diagnose issues with your setup.
 npx @capgo/cli@latest doctor
 ```
 
-### <a id="doctor-options"></a> Options
+## <a id="options-doctor"></a> Options (Doctor)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -202,7 +208,7 @@ Use --apikey=******** in any command to override it.
 npx @capgo/cli@latest login YOUR_API_KEY
 ```
 
-### <a id="login-options"></a> Options
+## <a id="options-login"></a> Options (Login)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |
@@ -238,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 |
@@ -256,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 |
@@ -271,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) |
@@ -307,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) |
@@ -333,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) |
@@ -360,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) |
 
@@ -384,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) |
 
@@ -409,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) |
@@ -438,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**
@@ -484,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) |
@@ -518,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) |
 
@@ -542,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) |
 
@@ -566,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) |
 
@@ -589,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) |
 
@@ -637,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) |
@@ -670,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) |
 
@@ -696,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) |
@@ -722,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) |
 
@@ -744,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) |
@@ -771,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 |
@@ -822,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 |
 
@@ -847,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**
 
@@ -886,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**
@@ -913,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) |
 
@@ -937,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) |
 
@@ -967,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) |
 
@@ -992,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 |
@@ -1010,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) |
 
@@ -1035,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) |
 
@@ -1058,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) |
 
@@ -1076,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) |
 
@@ -1096,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 |
@@ -1114,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) |
 
@@ -1132,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) |
 
@@ -1164,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**
 
@@ -1217,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)
@@ -1238,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**
 
@@ -1255,7 +1432,7 @@ and reports whether an update would be delivered, or explains why not.
 npx @capgo/cli@latest probe --platform ios
 ```
 
-### <a id="probe-options"></a> Options
+## <a id="options-probe"></a> Options (Probe)
 
 | Param          | Type          | Description          |
 | -------------- | ------------- | -------------------- |