| name | capgo-cli-operator |
| description | Execute and explain Capgo CLI workflows for setup, bundle operations, channels, compatibility, encryption, organizations, cloud build, and MCP. |
Capgo CLI Operator
Use this skill whenever the user asks how to operate Capgo from the CLI.
Operator Principles
- Always provide copy/paste-ready command sequences.
- Resolve placeholders when app/channel/bundle info is available.
- Include compatibility and release-type gates before promotion.
- Include rollback commands in every production rollout plan.
Full Command Surface
Core bootstrap
npx @capgo/cli@latest login
npx @capgo/cli@latest init
npx @capgo/cli@latest doctor
Bundle operations
npx @capgo/cli@latest bundle zip <appId> --path <webBuildPath>
npx @capgo/cli@latest bundle upload <appId> --path <webBuildPath> --channel <channel>
npx @capgo/cli@latest bundle compatibility <appId> --channel <channel>
npx @capgo/cli@latest bundle releaseType <appId> --channel <channel>
npx @capgo/cli@latest bundle list <appId>
npx @capgo/cli@latest bundle cleanup <appId> --keep <count>
npx @capgo/cli@latest bundle delete <bundleVersion> <appId>
npx @capgo/cli@latest bundle encrypt <zipFile> <checksum>
npx @capgo/cli@latest bundle decrypt <encryptedZipFile> <checksum>
App management
npx @capgo/cli@latest app add <appId>
npx @capgo/cli@latest app list
npx @capgo/cli@latest app set <appId> --name <name>
npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "production"
npx @capgo/cli@latest app debug <appId>
npx @capgo/cli@latest app delete <appId>
Channel management
npx @capgo/cli@latest channel add <channel> <appId>
npx @capgo/cli@latest channel list <appId>
npx @capgo/cli@latest channel currentBundle <channel> <appId>
npx @capgo/cli@latest channel set <channel> <appId> --bundle <bundleVersion>
npx @capgo/cli@latest channel set <channel> <appId> --disable-auto-update patch
npx @capgo/cli@latest channel delete <channel> <appId>
Key and encryption management
npx @capgo/cli@latest key create
npx @capgo/cli@latest key save
npx @capgo/cli@latest key delete_old
Account and organization management
npx @capgo/cli@latest account id
npx @capgo/cli@latest organization list
npx @capgo/cli@latest organization add --name <orgName> --email <adminEmail>
npx @capgo/cli@latest organization members <orgId>
npx @capgo/cli@latest organization set <orgId> --enforce-2fa
npx @capgo/cli@latest organization delete <orgId>
Cloud build and credentials
npx @capgo/cli@latest build credentials
npx @capgo/cli@latest build request <appId> --platform ios --path .
npx @capgo/cli@latest build request <appId> --platform android --path .
MCP server
npx @capgo/cli@latest mcp
Standard Runbooks
First-time project setup
- Authenticate and initialize.
- Register app and channels.
- Upload first staging bundle.
- Set bundle explicitly on staging.
- Verify compatibility before beta/production.
Safe staged rollout
- Check current bundle on target channel.
- Run compatibility and release-type checks.
- Publish to staging then beta.
- Promote to production after gate pass.
- Watch monitoring window and keep rollback ready.
Emergency rollback
- Query current production bundle.
- Select known-good previous bundle.
- Reassign production channel to known-good bundle.
- Validate startup and update health.
- Draft incident summary and fix-forward plan.
Troubleshooting Patterns
doctor fails: verify config/appId/updater install, then rerun.bundle compatibility fails: inspect package metadata mismatch and native dependency drift.releaseType returns native: stop OTA path and schedule store release.- channel update unexpected: check
channel currentBundle and channel targeting flags.
- update not applied: verify
notifyAppReady() path and app debug events.
Response Requirements
- Include command blocks in execution order.
- Include expected outputs for gate commands.
- Include rollback command in every production plan.
- Flag destructive commands and request confirmation step.
