---
title: Capawesome CLI 4.7.0 Release
description: Capawesome CLI 4.7.0 introduces a unified live update command, app transfer and linking, ad hoc build variables, and source map warnings.
date:
  created: 2026-04-04
  updated: 2026-08-05
authors:
  - robingenz
categories:
  - Announcements
  - Cloud
---

# Capawesome CLI 4.7.0 Release

Version 4.7.0 of the [Capawesome CLI](../../cloud/cli/index.md) is now available. Building on the [4.5.0 release](./capawesome-cli-4-5-0-release.md), 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.

<!-- more -->

<div class="capawesome-z29o10a">
  <a href="https://capawesome.io/" target="_blank">
    <img alt="Build and deploy your Capacitor app with Capawesome Cloud" src="https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
  </a>
</div>

## Unified Live Update Command

The new [`apps:liveupdates:create`](../../cloud/cli/commands.md#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:

```bash
npx @capawesome/cli apps:liveupdates:create \
  --app-id your-app-id \
  --git-ref main \
  --channel production
```

You can deploy to multiple channels at once by specifying `--channel` more than once:

```bash
npx @capawesome/cli apps:liveupdates:create \
  --app-id your-app-id \
  --git-ref main \
  --channel staging \
  --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

Two new commands let you connect and disconnect git repositories to your apps directly from the CLI:

- [`apps:link`](../../cloud/cli/commands.md#appslink): Connect a git repository to an app
- [`apps:unlink`](../../cloud/cli/commands.md#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:

```bash
npx @capawesome/cli apps:link \
  --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

The new [`apps:transfer`](../../cloud/cli/commands.md#appstransfer) command lets you move an app from one organization to another without having to recreate it:

```bash
npx @capawesome/cli apps:transfer \
  --app-id your-app-id \
  --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

The [`apps:builds:create`](../../cloud/cli/commands.md#appsbuildscreate) and [`apps:liveupdates:create`](../../cloud/cli/commands.md#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:

```bash
npx @capawesome/cli apps:builds:create \
  --app-id your-app-id \
  --platform android \
  --git-ref main \
  --variable "API_URL=https://api.example.com" \
  --variable "DEBUG=false"
```

You can also load variables from a file using `--variable-file`:

```bash
npx @capawesome/cli apps:builds:create \
  --app-id your-app-id \
  --platform ios \
  --git-ref main \
  --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

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`](../../cloud/cli/commands.md#appsliveupdatesbundle), [`apps:liveupdates:upload`](../../cloud/cli/commands.md#appsliveupdatesupload), and [`apps:liveupdates:generatemanifest`](../../cloud/cli/commands.md#appsliveupdatesgeneratemanifest) — no extra configuration needed.

## Other Improvements

Here are some additional changes in v4.6.0–v4.7.0:

- **Batch device operations**: The [`apps:devices:forcechannel`](../../cloud/cli/commands.md#appsdevicesforcechannel) and [`apps:devices:unforcechannel`](../../cloud/cli/commands.md#appsdevicesunforcechannel) commands now accept multiple `--device-id` flags, so you can update several devices at once.
- **Certificate type filtering**: The [`apps:certificates:get`](../../cloud/cli/commands.md#appscertificatesget) and [`apps:certificates:delete`](../../cloud/cli/commands.md#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

To upgrade to the latest version, run:

```bash
npm install -g @capawesome/cli@latest
```

## Try Capawesome Cloud

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://capawesome.io){ .md-button .md-button--primary }

## Final Thoughts

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 everything that shipped after this release, read the [Capawesome CLI 4.18.0 Release](./capawesome-cli-4-18-0-release.md) blog post. For more details on previous releases, check out the [Capawesome CLI 4.5.0 Release](./capawesome-cli-4-5-0-release.md) blog post. If you have any questions, feel free to join the [Capawesome Discord server](https://discord.gg/VCXxSVjefW){:target="_blank"}. And don't forget to [subscribe to our newsletter](https://capawesome.io/newsletter/){:target="_blank"} to stay updated on the latest releases.
