---
title: Monitor a Native Build
description: Track the status of your native iOS and Android builds in Capawesome Cloud, read build logs, download artifacts, and cancel a running build.
---

# Monitor a Build

After you [trigger a build](builds.md), you can follow its progress, read its logs, download the result, and cancel it if needed — from the [CLI](../cli/index.md) or the [Console](https://console.cloud.capawesome.io){:target="_blank"}.

Every build moves through a handful of states: **queued** (waiting for a free runner), **pending** (a runner has been assigned and is picking up the job), **in progress** (building), and then a final **succeeded**, **failed**, or **canceled**.

## Track build status

=== "CLI"

    List recent builds, or fetch a single build to check its current status:

    ```bash
    npx @capawesome/cli apps:builds:list
    npx @capawesome/cli apps:builds:get
    ```

    `apps:builds:list` accepts `--platform` to filter by `android`, `ios`, or `web`, and `--limit`/`--offset` to page through results. Add `--json` to either command to get machine-readable output — including the related job's status and timing, which is useful in scripts.

=== "Console"

    Open the [Builds](https://console.cloud.capawesome.io/apps/_/builds){:target="_blank"} page to see all builds and their status at a glance. Click a build to open its detail page, where the status updates live while it runs.

## Read the logs

The logs are the fastest way to understand what a build is doing — and why it failed.

=== "CLI"

    Stream the logs of an ongoing build, or print them for a completed one:

    ```bash
    npx @capawesome/cli apps:builds:logs
    ```

=== "Console"

    Open the build's detail page to follow the logs live and review them again after the build finishes.

See [Build logs](build-logs.md) for more. If a build failed, the quickest way to understand why is [Ask AI](../assist/ask-ai.md), or work through [Troubleshooting](troubleshooting.md).

## Download the artifact

Once a build succeeds, grab its artifact — an `.apk`/`.aab` for Android, an `.ipa` for iOS, or a `.zip` of web assets.

=== "CLI"

    Use [`apps:builds:download`](../cli/commands.md#appsbuildsdownload) with the flag for the artifact you want — optionally followed by a file path:

    ```bash
    npx @capawesome/cli apps:builds:download --apk ./app.apk
    ```

=== "Console"

    Open the build's detail page and download the artifact directly, or click **Install** to side-load it onto a device.

To install a build on a physical device, see [Install on a device](install-on-device.md).

## Cancel a build

Need to stop a queued or running build? Cancel it to free up your build minutes.

=== "CLI"

    ```bash
    npx @capawesome/cli apps:builds:cancel
    ```

=== "Console"

    Open the running build's detail page and click **Cancel**.

## Next steps

- [Install on a device](install-on-device.md) — download and side-load the artifact.
- [Build logs](build-logs.md) — read and interpret your build output.
- [Troubleshooting](troubleshooting.md) — fix a failing build.