📱 app

📱 Manage your Capgo app settings and configurations in Capgo Cloud.

➕ Add

Alias: a

npx @capgo/cli@latest app add

➕ Add a new app to Capgo Cloud with a unique app ID in the format com.test.app. All options can be guessed from config if not provided.

Example:

npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png

Options:

Param	Type	Description
-n	string	App name for display in Capgo Cloud
-i	string	App icon path for display in Capgo Cloud
-a	string	API key to link to your account
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🗑️ Delete

npx @capgo/cli@latest app delete

🗑️ Delete an app from Capgo Cloud, optionally specifying a version to delete only that bundle.

Example:

npx @capgo/cli@latest app delete com.example.app

Options:

Param	Type	Description
-a	string	API key to link to your account
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

📋 List

Alias: l

npx @capgo/cli@latest app list

📋 List all apps registered under your account in Capgo Cloud.

Example:

npx @capgo/cli@latest app list

Options:

Param	Type	Description
-a	string	API key to link to your account
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🐞 Debug

npx @capgo/cli@latest app debug

🐞 Listen for live update events in Capgo Cloud to debug your app. Optionally target a specific device for detailed diagnostics.

Example:

npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID

Options:

Param	Type	Description
-a	string	API key to link to your account
-d	string	The specific device ID to debug
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

⚙️ Setting

npx @capgo/cli@latest app setting

⚙️ Modify Capacitor configuration programmatically. Specify setting path (e.g., plugins.CapacitorUpdater.defaultChannel) with —string or —bool.

Example:

npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "Production"

Options:

Param	Type	Description
—bool	string	A value for the setting to modify as a boolean, ex: —bool true
—string	string	A value for the setting to modify as a string, ex: —string “Production”

⚙️ Set

Alias: s

npx @capgo/cli@latest app set

⚙️ Update settings for an existing app in Capgo Cloud, such as name, icon, or retention period for bundles. Retention of 0 means infinite storage.

Example:

npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 30

Options:

Param	Type	Description
-n	string	App name for display in Capgo Cloud
-i	string	Local image file path (png, jpg, webp, svg) used as the app icon in Capgo Cloud
-a	string	API key to link to your account
-r	string	Days to keep old bundles (0 = infinite, default: 0)
—expose-metadata	string	Expose bundle metadata (link and comment) to the plugin (true/false, default: false)
—preview	boolean	Enable bundle and channel preview QR codes for this app
—no-preview	boolean	Disable bundle and channel preview QR codes for this app
—allow-device-custom-id	boolean	Allow devices to set a custom device ID for this app
—no-allow-device-custom-id	boolean	Disallow custom device IDs for this app
—block-provider-infra-requests	boolean	Block provider infrastructure requests for this app
—no-block-provider-infra-requests	boolean	Allow provider infrastructure requests for this app
—build-timeout-minutes	string	Native build timeout in minutes (5-360, default: 15)
—ios-store-url	string	iOS App Store URL for this app
—android-store-url	string	Google Play Store URL for this app
—default-upload-channel	string	Default upload channel name for this app
—default-download-channel	string	Default download channel name for this app (sets channel public=true)
—disable-download-channels	boolean	Disable Capgo download channels for this app (sets all channels public=false)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Custom Supabase anon key (for self-hosting)