@capgo/cli 7.3.3 โ†’ 7.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -7,6 +7,9 @@
7
7
 
8
8
  A CLI to upload and download files from the Capgo Cloud.
9
9
 
10
+ You can find the most up to date version of this doc in our web doc:
11
+ https://capgo.app/docs/cli/overview/
12
+
10
13
  ## Usage
11
14
 
12
15
  Before use the CLI, you should register here : https://capgo.app/
@@ -15,6 +18,811 @@ Then go to your account in `apikey` section and click in the `all` key to copy i
15
18
 
16
19
  Follow the documentation here : "https://capacitorjs.com/docs/getting-started/
17
20
 
21
+ <!-- AUTO-GENERATED-DOCS-START -->
22
+ ## ๐Ÿ“‘ Capgo CLI Commands
23
+
24
+ ## ๐Ÿ“‹ Table of Contents
25
+
26
+ - [Init](#init)
27
+ - [Doctor](#doctor)
28
+ - [Login](#login)
29
+ - [Bundle](#bundle)
30
+ - [Upload](#bundle-upload)
31
+ - [Compatibility](#bundle-compatibility)
32
+ - [Delete](#bundle-delete)
33
+ - [List](#bundle-list)
34
+ - [Cleanup](#bundle-cleanup)
35
+ - [Encrypt](#bundle-encrypt)
36
+ - [Decrypt](#bundle-decrypt)
37
+ - [Zip](#bundle-zip)
38
+ - [App](#app)
39
+ - [Add](#app-add)
40
+ - [Delete](#app-delete)
41
+ - [List](#app-list)
42
+ - [Debug](#app-debug)
43
+ - [Setting](#app-setting)
44
+ - [Set](#app-set)
45
+ - [Channel](#channel)
46
+ - [Add](#channel-add)
47
+ - [Delete](#channel-delete)
48
+ - [List](#channel-list)
49
+ - [CurrentBundle](#channel-currentBundle)
50
+ - [Set](#channel-set)
51
+ - [Key](#key)
52
+ - [Save](#key-save)
53
+ - [Create](#key-create)
54
+ - [Delete_old](#key-delete_old)
55
+ - [Account](#account)
56
+ - [Id](#account-id)
57
+
58
+ ### <a id="init"></a> ๐Ÿš€ **Init**
59
+
60
+ **Alias:** `i`
61
+
62
+ ```bash
63
+ npx @capgo/cli@latest init
64
+ ```
65
+
66
+ ๐Ÿš€ Initialize a new app in Capgo Cloud with step-by-step guidance.
67
+
68
+ This includes adding code for updates, building, uploading your app, and verifying update functionality.
69
+
70
+
71
+ **Example:**
72
+
73
+ ```bash
74
+ npx @capgo/cli@latest init YOUR_API_KEY com.example.app
75
+ ```
76
+
77
+ **Options:**
78
+
79
+ | Param | Type | Description |
80
+ | -------------- | ------------- | -------------------- |
81
+ | **-n,** | <code>string</code> | App name for display in Capgo Cloud |
82
+ | **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
83
+ | **--supa-host** | <code>string</code> | Supabase host URL for custom setups |
84
+ | **--supa-anon** | <code>string</code> | Supabase anon token for custom setups |
85
+
86
+
87
+ ### <a id="doctor"></a> ๐Ÿ‘จโ€โš•๏ธ **Doctor**
88
+
89
+ ```bash
90
+ npx @capgo/cli@latest doctor
91
+ ```
92
+
93
+ ๐Ÿ‘จโ€โš•๏ธ Check if your Capgo app installation is up-to-date and gather information useful for bug reports.
94
+
95
+ This command helps diagnose issues with your setup.
96
+
97
+
98
+ **Example:**
99
+
100
+ ```bash
101
+ npx @capgo/cli@latest doctor
102
+ ```
103
+
104
+ **Options:**
105
+
106
+ | Param | Type | Description |
107
+ | -------------- | ------------- | -------------------- |
108
+ | **--package-json** | <code>string</code> | A list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json) |
109
+
110
+
111
+ ### <a id="login"></a> ๐Ÿ”‘ **Login**
112
+
113
+ **Alias:** `l`
114
+
115
+ ```bash
116
+ npx @capgo/cli@latest login
117
+ ```
118
+
119
+ ๐Ÿ”‘ Save your Capgo API key to your machine or local folder for easier access to Capgo Cloud services.
120
+
121
+ Use --apikey=******** in any command to override it.
122
+
123
+
124
+ **Example:**
125
+
126
+ ```bash
127
+ npx @capgo/cli@latest login YOUR_API_KEY
128
+ ```
129
+
130
+ **Options:**
131
+
132
+ | Param | Type | Description |
133
+ | -------------- | ------------- | -------------------- |
134
+ | **--local** | <code>boolean</code> | Only save in local folder, git ignored for security. |
135
+
136
+
137
+ ### <a id="bundle"></a> ๐Ÿ“ฆ **Bundle**
138
+
139
+ ```bash
140
+ npx @capgo/cli@latest bundle
141
+ ```
142
+
143
+ ๐Ÿ“ฆ Manage app bundles for deployment in Capgo Cloud, including upload, compatibility checks, and encryption.
144
+
145
+ #### BUNDLE Subcommands:
146
+
147
+ #### <a id="bundle-upload"></a> โฌ†๏ธ **Upload**
148
+
149
+ **Alias:** `u`
150
+
151
+ ```bash
152
+ npx @capgo/cli@latest bundle upload
153
+ ```
154
+
155
+ โฌ†๏ธ Upload a new app bundle to Capgo Cloud for distribution, optionally linking to a channel or external URL.
156
+
157
+ External option supports privacy concerns or large apps (>200MB) by storing only the link.
158
+
159
+ Capgo never inspects external content. Encryption adds a trustless security layer.
160
+
161
+ Version must be > 0.0.0 and unique.
162
+
163
+ > โ„น๏ธ External option helps with corporate privacy concerns and apps larger than 200MB by storing only the link.
164
+
165
+
166
+ > โ„น๏ธ Capgo Cloud never looks at the content in the link for external options or in the code when stored.
167
+
168
+
169
+ > โ„น๏ธ You can add a second layer of security with encryption, making Capgo trustless.
170
+
171
+
172
+ > โ„น๏ธ Version should be greater than "0.0.0" and cannot be overridden or reused after deletion for security reasons.
173
+
174
+
175
+
176
+ **Example:**
177
+
178
+ ```bash
179
+ npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production
180
+ ```
181
+
182
+ **Options:**
183
+
184
+ | Param | Type | Description |
185
+ | -------------- | ------------- | -------------------- |
186
+ | **-a,** | <code>string</code> | API key to link to your account |
187
+ | **-p,** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
188
+ | **-c,** | <code>string</code> | Channel to link to |
189
+ | **-e,** | <code>string</code> | Link to external URL instead of upload to Capgo Cloud |
190
+ | **--iv-session-key** | <code>string</code> | Set the IV and session key for bundle URL external |
191
+ | **--s3-region** | <code>string</code> | Region for your S3 bucket |
192
+ | **--s3-apikey** | <code>string</code> | API key for your S3 endpoint |
193
+ | **--s3-apisecret** | <code>string</code> | API secret for your S3 endpoint |
194
+ | **--s3-endoint** | <code>string</code> | URL of S3 endpoint |
195
+ | **--s3-bucket-name** | <code>string</code> | Name for your AWS S3 bucket |
196
+ | **--s3-port** | <code>string</code> | Port for your S3 endpoint |
197
+ | **--no-s3-ssl** | <code>boolean</code> | Disable SSL for S3 upload |
198
+ | **--key-v2** | <code>string</code> | Custom path for private signing key (v2 system) |
199
+ | **--key-data-v2** | <code>string</code> | Private signing key (v2 system) |
200
+ | **--bundle-url** | <code>boolean</code> | Prints bundle URL into stdout |
201
+ | **--no-key** | <code>boolean</code> | Ignore signing key and send clear update |
202
+ | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
203
+ | **--display-iv-session** | <code>boolean</code> | Show in the console the IV and session key used to encrypt the update |
204
+ | **-b,** | <code>string</code> | Bundle version number of the bundle to upload |
205
+ | **--link** | <code>string</code> | Link to external resource (e.g. GitHub release) |
206
+ | **--comment** | <code>string</code> | Comment about this version, could be a release note, a commit hash, a commit message, etc. |
207
+ | **--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 |
208
+ | **--auto-min-update-version** | <code>boolean</code> | Set the min update version based on native packages |
209
+ | **--ignore-metadata-check** | <code>boolean</code> | Ignores the metadata (node_modules) check when uploading |
210
+ | **--ignore-checksum-check** | <code>boolean</code> | Ignores the checksum check when uploading |
211
+ | **--timeout** | <code>string</code> | Timeout for the upload process in seconds |
212
+ | **--multipart** | <code>boolean</code> | Uses multipart protocol to upload data to S3, Deprecated, use tus instead |
213
+ | **--zip** | <code>boolean</code> | Upload the bundle using zip to Capgo cloud (legacy) |
214
+ | **--tus** | <code>boolean</code> | Upload the bundle using TUS to Capgo cloud |
215
+ | **--tus-chunk-size** | <code>string</code> | Chunk size for the TUS upload |
216
+ | **--partial** | <code>boolean</code> | Upload partial files to Capgo cloud |
217
+ | **--partial-only** | <code>boolean</code> | Upload only partial files to Capgo cloud, skip the zipped file, useful for big bundle |
218
+ | **--encrypted-checksum** | <code>string</code> | An encrypted checksum (signature). Used only when uploading an external bundle. |
219
+ | **--auto-set-bundle** | <code>boolean</code> | Set the bundle in capacitor.config.json |
220
+ | **--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) |
221
+ | **--package-json** | <code>string</code> | A list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json) |
222
+ | **--node-modules** | <code>string</code> | A list of paths to node_modules. Useful for monorepos (comma separated ex: ../../node_modules,./node_modules) |
223
+ | **--encrypt-partial** | <code>boolean</code> | Encrypt the partial update files (automatically applied for updater > 6.14.4) |
224
+ | **--delete-linked-bundle-on-upload** | <code>boolean</code> | Locates the currently linked bundle in the channel you are trying to upload to, and deletes it |
225
+ | **--no-brotli-patterns** | <code>string</code> | Glob patterns for files to exclude from brotli compression (comma-separated) |
226
+ | **--disable-brotli** | <code>boolean</code> | Completely disable brotli compression even if updater version supports it |
227
+ | **--supa-host** | <code>string</code> | Supabase host URL, for self-hosted Capgo or testing |
228
+ | **--supa-anon** | <code>string</code> | Supabase anon token, for self-hosted Capgo or testing |
229
+
230
+ #### <a id="bundle-compatibility"></a> ๐Ÿงช **Compatibility**
231
+
232
+ ```bash
233
+ npx @capgo/cli@latest bundle compatibility
234
+ ```
235
+
236
+ ๐Ÿงช Check compatibility of a bundle with a specific channel in Capgo Cloud to ensure updates are safe.
237
+
238
+
239
+ **Example:**
240
+
241
+ ```bash
242
+ npx @capgo/cli@latest bundle compatibility com.example.app --channel production
243
+ ```
244
+
245
+ **Options:**
246
+
247
+ | Param | Type | Description |
248
+ | -------------- | ------------- | -------------------- |
249
+ | **-a,** | <code>string</code> | API key to link to your account |
250
+ | **-c,** | <code>string</code> | Channel to check the compatibility with |
251
+ | **--text** | <code>boolean</code> | Output text instead of emojis |
252
+ | **--package-json** | <code>string</code> | A list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json) |
253
+ | **--node-modules** | <code>string</code> | A list of paths to node_modules. Useful for monorepos (comma separated ex: ../../node_modules,./node_modules) |
254
+
255
+ #### <a id="bundle-delete"></a> ๐Ÿ—‘๏ธ **Delete**
256
+
257
+ **Alias:** `d`
258
+
259
+ ```bash
260
+ npx @capgo/cli@latest bundle delete
261
+ ```
262
+
263
+ ๐Ÿ—‘๏ธ Delete a specific bundle from Capgo Cloud, optionally targeting a single version.
264
+
265
+
266
+ **Example:**
267
+
268
+ ```bash
269
+ npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app
270
+ ```
271
+
272
+ **Options:**
273
+
274
+ | Param | Type | Description |
275
+ | -------------- | ------------- | -------------------- |
276
+ | **-a,** | <code>string</code> | API key to link to your account |
277
+
278
+ #### <a id="bundle-list"></a> ๐Ÿ“‹ **List**
279
+
280
+ **Alias:** `l`
281
+
282
+ ```bash
283
+ npx @capgo/cli@latest bundle list
284
+ ```
285
+
286
+ ๐Ÿ“‹ List all bundles uploaded for an app in Capgo Cloud.
287
+
288
+
289
+ **Example:**
290
+
291
+ ```bash
292
+ npx @capgo/cli@latest bundle list com.example.app
293
+ ```
294
+
295
+ **Options:**
296
+
297
+ | Param | Type | Description |
298
+ | -------------- | ------------- | -------------------- |
299
+ | **-a,** | <code>string</code> | API key to link to your account |
300
+
301
+ #### <a id="bundle-cleanup"></a> ๐Ÿงน **Cleanup**
302
+
303
+ **Alias:** `c`
304
+
305
+ ```bash
306
+ npx @capgo/cli@latest bundle cleanup
307
+ ```
308
+
309
+ ๐Ÿงน Cleanup old bundles in Capgo Cloud, keeping a specified number of recent versions or those linked to channels.
310
+
311
+ Ignores bundles in use.
312
+
313
+
314
+ **Example:**
315
+
316
+ ```bash
317
+ npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3
318
+ ```
319
+
320
+ **Options:**
321
+
322
+ | Param | Type | Description |
323
+ | -------------- | ------------- | -------------------- |
324
+ | **-b,** | <code>string</code> | Bundle version number of the app to delete |
325
+ | **-a,** | <code>string</code> | API key to link to your account |
326
+ | **-k,** | <code>string</code> | Number of versions to keep |
327
+ | **-f,** | <code>string</code> | Force removal |
328
+ | **--ignore-channel** | <code>boolean</code> | Delete all versions even if linked to a channel, this will delete channel as well |
329
+
330
+ #### <a id="bundle-encrypt"></a> ๐Ÿ”’ **Encrypt**
331
+
332
+ ```bash
333
+ npx @capgo/cli@latest bundle encrypt
334
+ ```
335
+
336
+ ๐Ÿ”’ Encrypt a zip bundle using the new encryption method for secure external storage or testing.
337
+
338
+ Used with external sources or for testing, prints ivSessionKey for upload or decryption.
339
+
340
+
341
+ **Example:**
342
+
343
+ ```bash
344
+ npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
345
+ ```
346
+
347
+ **Options:**
348
+
349
+ | Param | Type | Description |
350
+ | -------------- | ------------- | -------------------- |
351
+ | **--key** | <code>string</code> | Custom path for private signing key |
352
+ | **--key-data** | <code>string</code> | Private signing key |
353
+ | **-j,** | <code>string</code> | Output in JSON |
354
+
355
+ #### <a id="bundle-decrypt"></a> ๐Ÿ”“ **Decrypt**
356
+
357
+ ```bash
358
+ npx @capgo/cli@latest bundle decrypt
359
+ ```
360
+
361
+ ๐Ÿ”“ Decrypt a zip bundle using the new encryption method, mainly for testing purposes.
362
+
363
+ Prints the base64 decrypted session key for verification.
364
+
365
+
366
+ **Example:**
367
+
368
+ ```bash
369
+ npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM
370
+ ```
371
+
372
+ **Options:**
373
+
374
+ | Param | Type | Description |
375
+ | -------------- | ------------- | -------------------- |
376
+ | **--key** | <code>string</code> | Custom path for private signing key |
377
+ | **--key-data** | <code>string</code> | Private signing key |
378
+ | **--checksum** | <code>string</code> | Checksum of the bundle, to verify the integrity of the bundle |
379
+
380
+ #### <a id="bundle-zip"></a> ๐Ÿ”น **Zip**
381
+
382
+ ```bash
383
+ npx @capgo/cli@latest bundle zip
384
+ ```
385
+
386
+ ๐Ÿ—œ๏ธ Create a zip file of your app bundle for upload or local storage.
387
+
388
+ Useful for preparing bundles before encryption or upload.
389
+
390
+
391
+ **Example:**
392
+
393
+ ```bash
394
+ npx @capgo/cli@latest bundle zip com.example.app --path ./dist
395
+ ```
396
+
397
+ **Options:**
398
+
399
+ | Param | Type | Description |
400
+ | -------------- | ------------- | -------------------- |
401
+ | **-p,** | <code>string</code> | Path of the folder to upload, if not provided it will use the webDir set in capacitor.config |
402
+ | **-b,** | <code>string</code> | Bundle version number to name the zip file |
403
+ | **-n,** | <code>string</code> | Name of the zip file |
404
+ | **-j,** | <code>string</code> | Output in JSON |
405
+ | **--no-code-check** | <code>boolean</code> | Ignore checking if notifyAppReady() is called in source code and index present in root folder |
406
+ | **--key-v2** | <code>boolean</code> | Use encryption v2 |
407
+ | **--package-json** | <code>string</code> | A list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json) |
408
+
409
+
410
+ ### <a id="app"></a> ๐Ÿ“ฑ **App**
411
+
412
+ ```bash
413
+ npx @capgo/cli@latest app
414
+ ```
415
+
416
+ ๐Ÿ“ฑ Manage your Capgo app settings and configurations in Capgo Cloud.
417
+
418
+ #### APP Subcommands:
419
+
420
+ #### <a id="app-add"></a> โž• **Add**
421
+
422
+ **Alias:** `a`
423
+
424
+ ```bash
425
+ npx @capgo/cli@latest app add
426
+ ```
427
+
428
+ โž• Add a new app to Capgo Cloud with a unique app ID in the format com.test.app.
429
+
430
+ All options can be guessed from config if not provided.
431
+
432
+
433
+ **Example:**
434
+
435
+ ```bash
436
+ npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png
437
+ ```
438
+
439
+ **Options:**
440
+
441
+ | Param | Type | Description |
442
+ | -------------- | ------------- | -------------------- |
443
+ | **-n,** | <code>string</code> | App name for display in Capgo Cloud |
444
+ | **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
445
+ | **-a,** | <code>string</code> | API key to link to your account |
446
+
447
+ #### <a id="app-delete"></a> ๐Ÿ—‘๏ธ **Delete**
448
+
449
+ ```bash
450
+ npx @capgo/cli@latest app delete
451
+ ```
452
+
453
+ ๐Ÿ—‘๏ธ Delete an app from Capgo Cloud, optionally specifying a version to delete only that bundle.
454
+
455
+
456
+ **Example:**
457
+
458
+ ```bash
459
+ npx @capgo/cli@latest app delete com.example.app
460
+ ```
461
+
462
+ **Options:**
463
+
464
+ | Param | Type | Description |
465
+ | -------------- | ------------- | -------------------- |
466
+ | **-a,** | <code>string</code> | API key to link to your account |
467
+
468
+ #### <a id="app-list"></a> ๐Ÿ“‹ **List**
469
+
470
+ **Alias:** `l`
471
+
472
+ ```bash
473
+ npx @capgo/cli@latest app list
474
+ ```
475
+
476
+ ๐Ÿ“‹ List all apps registered under your account in Capgo Cloud.
477
+
478
+
479
+ **Example:**
480
+
481
+ ```bash
482
+ npx @capgo/cli@latest app list
483
+ ```
484
+
485
+ **Options:**
486
+
487
+ | Param | Type | Description |
488
+ | -------------- | ------------- | -------------------- |
489
+ | **-a,** | <code>string</code> | API key to link to your account |
490
+
491
+ #### <a id="app-debug"></a> ๐Ÿž **Debug**
492
+
493
+ ```bash
494
+ npx @capgo/cli@latest app debug
495
+ ```
496
+
497
+ ๐Ÿž Listen for live update events in Capgo Cloud to debug your app.
498
+
499
+ Optionally target a specific device for detailed diagnostics.
500
+
501
+
502
+ **Example:**
503
+
504
+ ```bash
505
+ npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID
506
+ ```
507
+
508
+ **Options:**
509
+
510
+ | Param | Type | Description |
511
+ | -------------- | ------------- | -------------------- |
512
+ | **-a,** | <code>string</code> | API key to link to your account |
513
+ | **-d,** | <code>string</code> | The specific device ID to debug |
514
+
515
+ #### <a id="app-setting"></a> โš™๏ธ **Setting**
516
+
517
+ ```bash
518
+ npx @capgo/cli@latest app setting
519
+ ```
520
+
521
+ โš™๏ธ Modify Capacitor configuration programmatically by specifying the path to the setting.
522
+
523
+ (e.g., plugins.CapacitorUpdater.defaultChannel). You MUST provide either --string or --bool.
524
+
525
+
526
+ **Example:**
527
+
528
+ ```bash
529
+ npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "Production"
530
+ ```
531
+
532
+ **Options:**
533
+
534
+ | Param | Type | Description |
535
+ | -------------- | ------------- | -------------------- |
536
+ | **--bool** | <code>string</code> | A value for the setting to modify as a boolean, ex: --bool true |
537
+ | **--string** | <code>string</code> | A value for the setting to modify as a string, ex: --string "Production" |
538
+
539
+ #### <a id="app-set"></a> โš™๏ธ **Set**
540
+
541
+ **Alias:** `s`
542
+
543
+ ```bash
544
+ npx @capgo/cli@latest app set
545
+ ```
546
+
547
+ โš™๏ธ Update settings for an existing app in Capgo Cloud, such as name, icon, or retention period for bundles.
548
+
549
+ Retention of 0 means infinite storage.
550
+
551
+
552
+ **Example:**
553
+
554
+ ```bash
555
+ npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 30
556
+ ```
557
+
558
+ **Options:**
559
+
560
+ | Param | Type | Description |
561
+ | -------------- | ------------- | -------------------- |
562
+ | **-n,** | <code>string</code> | App name for display in Capgo Cloud |
563
+ | **-i,** | <code>string</code> | App icon path for display in Capgo Cloud |
564
+ | **-a,** | <code>string</code> | API key to link to your account |
565
+ | **-r,** | <code>string</code> | Retention period of app bundle in days, 0 by default = infinite |
566
+
567
+
568
+ ### <a id="channel"></a> ๐Ÿ“ข **Channel**
569
+
570
+ ```bash
571
+ npx @capgo/cli@latest channel
572
+ ```
573
+
574
+ ๐Ÿ“ข Manage distribution channels for app updates in Capgo Cloud, controlling how updates are delivered to devices.
575
+
576
+ #### CHANNEL Subcommands:
577
+
578
+ #### <a id="channel-add"></a> โž• **Add**
579
+
580
+ **Alias:** `a`
581
+
582
+ ```bash
583
+ npx @capgo/cli@latest channel add
584
+ ```
585
+
586
+ โž• Create a new channel for app distribution in Capgo Cloud to manage update delivery.
587
+
588
+
589
+ **Example:**
590
+
591
+ ```bash
592
+ npx @capgo/cli@latest channel add production com.example.app --default
593
+ ```
594
+
595
+ **Options:**
596
+
597
+ | Param | Type | Description |
598
+ | -------------- | ------------- | -------------------- |
599
+ | **-d,** | <code>string</code> | Set the channel as default |
600
+ | **-a,** | <code>string</code> | API key to link to your account |
601
+
602
+ #### <a id="channel-delete"></a> ๐Ÿ—‘๏ธ **Delete**
603
+
604
+ **Alias:** `d`
605
+
606
+ ```bash
607
+ npx @capgo/cli@latest channel delete
608
+ ```
609
+
610
+ ๐Ÿ—‘๏ธ Delete a channel from Capgo Cloud, optionally removing associated bundles to free up resources.
611
+
612
+
613
+ **Example:**
614
+
615
+ ```bash
616
+ npx @capgo/cli@latest channel delete production com.example.app
617
+ ```
618
+
619
+ **Options:**
620
+
621
+ | Param | Type | Description |
622
+ | -------------- | ------------- | -------------------- |
623
+ | **-a,** | <code>string</code> | API key to link to your account |
624
+ | **--delete-bundle** | <code>boolean</code> | Delete the bundle associated with the channel |
625
+
626
+ #### <a id="channel-list"></a> ๐Ÿ“‹ **List**
627
+
628
+ **Alias:** `l`
629
+
630
+ ```bash
631
+ npx @capgo/cli@latest channel list
632
+ ```
633
+
634
+ ๐Ÿ“‹ List all channels configured for an app in Capgo Cloud to review distribution settings.
635
+
636
+
637
+ **Example:**
638
+
639
+ ```bash
640
+ npx @capgo/cli@latest channel list com.example.app
641
+ ```
642
+
643
+ **Options:**
644
+
645
+ | Param | Type | Description |
646
+ | -------------- | ------------- | -------------------- |
647
+ | **-a,** | <code>string</code> | API key to link to your account |
648
+
649
+ #### <a id="channel-currentBundle"></a> ๐Ÿ“ฆ **CurrentBundle**
650
+
651
+ ```bash
652
+ npx @capgo/cli@latest channel currentBundle
653
+ ```
654
+
655
+ ๐Ÿ“ฆ Get the current bundle linked to a specific channel in Capgo Cloud for update tracking.
656
+
657
+
658
+ **Example:**
659
+
660
+ ```bash
661
+ npx @capgo/cli@latest channel currentBundle production com.example.app
662
+ ```
663
+
664
+ **Options:**
665
+
666
+ | Param | Type | Description |
667
+ | -------------- | ------------- | -------------------- |
668
+ | **-c,** | <code>string</code> | Channel to get the current bundle from |
669
+ | **-a,** | <code>string</code> | API key to link to your account |
670
+ | **--quiet** | <code>boolean</code> | Only print the bundle version |
671
+
672
+ #### <a id="channel-set"></a> โš™๏ธ **Set**
673
+
674
+ **Alias:** `s`
675
+
676
+ ```bash
677
+ npx @capgo/cli@latest channel set
678
+ ```
679
+
680
+ โš™๏ธ Configure settings for a channel, such as linking a bundle, setting update strategies (major, minor, metadata, patch, none), or device targeting (iOS, Android, dev, emulator).
681
+
682
+ One channel must be default.
683
+
684
+
685
+ **Example:**
686
+
687
+ ```bash
688
+ npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default
689
+ ```
690
+
691
+ **Options:**
692
+
693
+ | Param | Type | Description |
694
+ | -------------- | ------------- | -------------------- |
695
+ | **-a,** | <code>string</code> | API key to link to your account |
696
+ | **-b,** | <code>string</code> | Bundle version number of the file to set |
697
+ | **-s,** | <code>string</code> | Set the state of the channel, default or normal |
698
+ | **--latest** | <code>boolean</code> | Get the latest version key in the package.json to set it to the channel |
699
+ | **--downgrade** | <code>boolean</code> | Allow to downgrade to version under native one |
700
+ | **--no-downgrade** | <code>boolean</code> | Disable downgrade to version under native one |
701
+ | **--upgrade** | <code>boolean</code> | Allow to upgrade to version above native one |
702
+ | **--no-upgrade** | <code>boolean</code> | Disable upgrade to version above native one |
703
+ | **--ios** | <code>boolean</code> | Allow sending update to iOS devices |
704
+ | **--no-ios** | <code>boolean</code> | Disable sending update to iOS devices |
705
+ | **--android** | <code>boolean</code> | Allow sending update to Android devices |
706
+ | **--no-android** | <code>boolean</code> | Disable sending update to Android devices |
707
+ | **--self-assign** | <code>boolean</code> | Allow device to self-assign to this channel |
708
+ | **--no-self-assign** | <code>boolean</code> | Disable devices to self-assign to this channel |
709
+ | **--disable-auto-update** | <code>string</code> | Disable auto update strategy for this channel. The possible options are: major, minor, metadata, patch, none |
710
+ | **--dev** | <code>boolean</code> | Allow sending update to development devices |
711
+ | **--no-dev** | <code>boolean</code> | Disable sending update to development devices |
712
+ | **--emulator** | <code>boolean</code> | Allow sending update to emulator devices |
713
+ | **--no-emulator** | <code>boolean</code> | Disable sending update to emulator devices |
714
+ | **--package-json** | <code>string</code> | A list of paths to package.json. Useful for monorepos (comma separated ex: ../../package.json,./package.json) |
715
+
716
+
717
+ ### <a id="key"></a> ๐Ÿ” **Key**
718
+
719
+ ```bash
720
+ npx @capgo/cli@latest key
721
+ ```
722
+
723
+ ๐Ÿ” Manage encryption keys for secure bundle distribution in Capgo Cloud, supporting end-to-end encryption with RSA and AES combination.
724
+
725
+ #### KEY Subcommands:
726
+
727
+ #### <a id="key-save"></a> ๐Ÿ”น **Save**
728
+
729
+ ```bash
730
+ npx @capgo/cli@latest key save
731
+ ```
732
+
733
+ ๐Ÿ’พ Save a base64 encryption key in the Capacitor config, useful for CI environments.
734
+
735
+ Recommended not to commit the key for security.
736
+
737
+
738
+ **Example:**
739
+
740
+ ```bash
741
+ npx @capgo/cli@latest key save --key ./path/to/key
742
+ ```
743
+
744
+ **Options:**
745
+
746
+ | Param | Type | Description |
747
+ | -------------- | ------------- | -------------------- |
748
+ | **-f,** | <code>string</code> | Force generate a new one |
749
+ | **--key** | <code>string</code> | Key path to save in Capacitor config |
750
+ | **--key-data** | <code>string</code> | Key data to save in Capacitor config |
751
+
752
+ #### <a id="key-create"></a> ๐Ÿ”จ **Create**
753
+
754
+ ```bash
755
+ npx @capgo/cli@latest key create
756
+ ```
757
+
758
+ ๐Ÿ”จ Create a new encryption key pair for end-to-end encryption in Capgo Cloud.
759
+
760
+ Do not commit or share the private key; save it securely.
761
+
762
+
763
+ **Example:**
764
+
765
+ ```bash
766
+ npx @capgo/cli@latest key create
767
+ ```
768
+
769
+ **Options:**
770
+
771
+ | Param | Type | Description |
772
+ | -------------- | ------------- | -------------------- |
773
+ | **-f,** | <code>string</code> | Force generate a new one |
774
+
775
+ #### <a id="key-delete_old"></a> ๐Ÿ—‘๏ธ **Delete_old**
776
+
777
+ ```bash
778
+ npx @capgo/cli@latest key delete_old
779
+ ```
780
+
781
+ ๐Ÿงน Delete the old encryption key from the Capacitor config to ensure only the current key is used.
782
+
783
+
784
+ **Example:**
785
+
786
+ ```bash
787
+ npx @capgo/cli@latest key delete_old
788
+ ```
789
+
790
+
791
+ ### <a id="account"></a> ๐Ÿ‘ค **Account**
792
+
793
+ ```bash
794
+ npx @capgo/cli@latest account
795
+ ```
796
+
797
+ ๐Ÿ‘ค Manage your Capgo account details and retrieve information for support or collaboration.
798
+
799
+ #### ACCOUNT Subcommands:
800
+
801
+ #### <a id="account-id"></a> ๐Ÿ”น **Id**
802
+
803
+ ```bash
804
+ npx @capgo/cli@latest account id
805
+ ```
806
+
807
+ ๐Ÿชช Retrieve your account ID, safe to share for collaboration or support purposes in Discord or other platforms.
808
+
809
+
810
+ **Example:**
811
+
812
+ ```bash
813
+ npx @capgo/cli@latest account id
814
+ ```
815
+
816
+ **Options:**
817
+
818
+ | Param | Type | Description |
819
+ | -------------- | ------------- | -------------------- |
820
+ | **-a,** | <code>string</code> | API key to link to your account |
821
+
822
+
823
+
824
+ <!-- AUTO-GENERATED-DOCS-END -->
825
+
18
826
  ### **Init**
19
827
 
20
828
  `npx @capgo/cli@latest init [apikey]`