--- description: Capawesome CLI 4.7.0 introduces a unified live update command, app transfer and linking, ad hoc build variables, and source map warnings. title: Capawesome CLI 4.7.0 Release - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/capawesome-cli-4-7-0-release.png --- [ Skip to content](#capawesome-cli-470-release) [ 🔐 Introducing the **Capacitor Vault** plugin — store secrets behind biometrics or a device passcode.](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm or Yarn ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories # Capawesome CLI 4.7.0 Release[¶](#capawesome-cli-470-release "Permanent link") Version 4.7.0 of the [Capawesome CLI](/docs/cloud/cli/) is now available. Building on the [4.5.0 release](/blog/capawesome-cli-4-5-0-release/), this update brings a unified command for creating live updates, new app management commands for linking repositories and transferring apps, ad hoc environment variables for builds, and source map detection to keep your production bundles clean. [ ![Build and deploy your Capacitor app with Capawesome Cloud](../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Unified Live Update Command[¶](#unified-live-update-command "Permanent link") The new [apps:liveupdates:create](/docs/cloud/cli/commands/#appsliveupdatescreate) command builds your web bundle on a Capawesome Cloud Runner and deploys it to one or more channels — all in a single command. Unlike local bundling and uploading, the build runs in a managed cloud environment, giving you consistent and reproducible builds every time. It also consolidates the previous two-step workflow of `apps:builds:create` and `apps:deployments:create` into one: `[](#%5F%5Fcodelineno-0-1)npx @capawesome/cli apps:liveupdates:create \ [](#%5F%5Fcodelineno-0-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-0-3) --git-ref main \ [](#%5F%5Fcodelineno-0-4) --channel production ` You can deploy to multiple channels at once by specifying `--channel` more than once: `[](#%5F%5Fcodelineno-1-1)npx @capawesome/cli apps:liveupdates:create \ [](#%5F%5Fcodelineno-1-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-1-3) --git-ref main \ [](#%5F%5Fcodelineno-1-4) --channel staging \ [](#%5F%5Fcodelineno-1-5) --channel production ` The command also supports gradual rollouts with `--rollout-percentage`, native version constraints, and custom properties — giving you full control over each live update deployment in a single command. In addition to `--git-ref`, you can use `--path` to upload local source files or `--url` to build from a remote ZIP file. ## App Linking[¶](#app-linking "Permanent link") Two new commands let you connect and disconnect git repositories to your apps directly from the CLI: * [apps:link](/docs/cloud/cli/commands/#appslink): Connect a git repository to an app * [apps:unlink](/docs/cloud/cli/commands/#appsunlink): Disconnect a git repository from an app The `apps:link` command automatically detects repository information from your local git remote, so all you need to do is run: `[](#%5F%5Fcodelineno-2-1)npx @capawesome/cli apps:link \ [](#%5F%5Fcodelineno-2-2) --app-id your-app-id ` This is particularly useful when setting up new projects or configuring CI/CD pipelines — the CLI figures out the git provider, owner, and repository name for you. ## App Transfer[¶](#app-transfer "Permanent link") The new [apps:transfer](/docs/cloud/cli/commands/#appstransfer) command lets you move an app from one organization to another without having to recreate it: `[](#%5F%5Fcodelineno-3-1)npx @capawesome/cli apps:transfer \ [](#%5F%5Fcodelineno-3-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-3-3) --organization-id target-org-id ` This comes in handy when reorganizing your workspace or handing off a project to another team. ## Ad Hoc Environment Variables[¶](#ad-hoc-environment-variables "Permanent link") The [apps:builds:create](/docs/cloud/cli/commands/#appsbuildscreate) and [apps:liveupdates:create](/docs/cloud/cli/commands/#appsliveupdatescreate) commands now support ad hoc environment variables that are passed directly to the build without having to configure them in the Cloud Console first: `[](#%5F%5Fcodelineno-4-1)npx @capawesome/cli apps:builds:create \ [](#%5F%5Fcodelineno-4-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-4-3) --platform android \ [](#%5F%5Fcodelineno-4-4) --git-ref main \ [](#%5F%5Fcodelineno-4-5) --variable "API_URL=https://api.example.com" \ [](#%5F%5Fcodelineno-4-6) --variable "DEBUG=false" ` You can also load variables from a file using `--variable-file`: `[](#%5F%5Fcodelineno-5-1)npx @capawesome/cli apps:builds:create \ [](#%5F%5Fcodelineno-5-2) --app-id your-app-id \ [](#%5F%5Fcodelineno-5-3) --platform ios \ [](#%5F%5Fcodelineno-5-4) --git-ref main \ [](#%5F%5Fcodelineno-5-5) --variable-file .env.production ` This makes it easy to customize builds on the fly — especially in CI/CD pipelines where you want to inject environment-specific values without persisting them in the Cloud Console. ## Source Map Detection[¶](#source-map-detection "Permanent link") The CLI now warns you when source maps are detected in your live update bundles. Source maps can unintentionally expose your source code to end users, so catching them before deployment helps keep your production builds secure. This check runs automatically during [apps:liveupdates:bundle](/docs/cloud/cli/commands/#appsliveupdatesbundle), [apps:liveupdates:upload](/docs/cloud/cli/commands/#appsliveupdatesupload), and [apps:liveupdates:generatemanifest](/docs/cloud/cli/commands/#appsliveupdatesgeneratemanifest) — no extra configuration needed. ## Other Improvements[¶](#other-improvements "Permanent link") Here are some additional changes in v4.6.0–v4.7.0: * **Batch device operations**: The [apps:devices:forcechannel](/docs/cloud/cli/commands/#appsdevicesforcechannel) and [apps:devices:unforcechannel](/docs/cloud/cli/commands/#appsdevicesunforcechannel) commands now accept multiple `--device-id` flags, so you can update several devices at once. * **Certificate type filtering**: The [apps:certificates:get](/docs/cloud/cli/commands/#appscertificatesget) and [apps:certificates:delete](/docs/cloud/cli/commands/#appscertificatesdelete) commands now support a `--type` option for more targeted certificate selection. * **Bug fixes**: Improved error messages for invalid private keys, fixed login token handling with extra whitespace, and better status reporting for canceled builds. ## Upgrading[¶](#upgrading "Permanent link") To upgrade to the latest version, run: `[](#%5F%5Fcodelineno-6-1)npm install -g @capawesome/cli@latest ` ## Try Capawesome Cloud[¶](#try-capawesome-cloud "Permanent link") If you haven't tried Capawesome Cloud yet, now is a great time to get started. Manage your builds, live updates, and app store submissions — all from the command line. [Try Capawesome Cloud Free](https://cloud.capawesome.io) ## Final Thoughts[¶](#final-thoughts "Permanent link") Capawesome CLI 4.7.0 makes live update workflows significantly simpler with the new unified `apps:liveupdates:create` command, and gives you more flexibility with ad hoc environment variables and app management features like linking and transferring. The source map detection adds an extra layer of safety to your deployment process. For more details on previous releases, check out the [Capawesome CLI 4.5.0 Release](/blog/capawesome-cli-4-5-0-release/) blog post. If you have any questions, feel free to join the [Capawesome Discord server](https://discord.gg/VCXxSVjefW). And don't forget to [subscribe to our newsletter](https://cloud.capawesome.io/newsletter) to stay updated on the latest releases. June 8, 2026 Back to top