Skip to content

📱 app

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

Add

Alias: a

Terminal window
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:

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

Options:

ParamTypeDescription
-n,stringApp name for display in Capgo Cloud
-i,stringApp icon path for display in Capgo Cloud
-a,stringAPI key to link to your account
—supa-hoststringSupabase host URL for custom setups
—supa-anonstringSupabase anon token for custom setups

🗑️ Delete

Terminal window
npx @capgo/cli@latest app delete

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

Example:

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

Options:

ParamTypeDescription
-a,stringAPI key to link to your account
—supa-hoststringSupabase host URL for custom setups
—supa-anonstringSupabase anon token for custom setups

📋 List

Alias: l

Terminal window
npx @capgo/cli@latest app list

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

Example:

Terminal window
npx @capgo/cli@latest app list

Options:

ParamTypeDescription
-a,stringAPI key to link to your account
—supa-hoststringSupabase host URL for custom setups
—supa-anonstringSupabase anon token for custom setups

🐞 Debug

Terminal window
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:

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

Options:

ParamTypeDescription
-a,stringAPI key to link to your account
-d,stringThe specific device ID to debug
—supa-hoststringSupabase host URL for custom setups
—supa-anonstringSupabase anon token for custom setups

⚙️ Setting

Terminal window
npx @capgo/cli@latest app setting

⚙️ Modify Capacitor configuration programmatically by specifying the path to the setting. (e.g., plugins.CapacitorUpdater.defaultChannel). You MUST provide either —string or —bool.

Example:

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

Options:

ParamTypeDescription
—boolstringA value for the setting to modify as a boolean, ex: —bool true
—stringstringA value for the setting to modify as a string, ex: —string “Production”

⚙️ Set

Alias: s

Terminal window
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:

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

Options:

ParamTypeDescription
-n,stringApp name for display in Capgo Cloud
-i,stringApp icon path for display in Capgo Cloud
-a,stringAPI key to link to your account
-r,stringRetention period of app bundle in days, 0 by default = infinite
—supa-hoststringSupabase host URL for custom setups
—supa-anonstringSupabase anon token for custom setups