momentic-mobile assets

Manage dashboard-hosted mobile assets: Android Package (APK) files and .app bundles. Each asset belongs to a release channel (e.g. staging, dev) and is identified by a version tag.

npx momentic-mobile assets upload <file> --channel <channel> --tag <tag>

`list`

List available asset channels and tags for your organization, grouped by platform. Without any flags, the command prints a summary of every channel under each platform heading with its tag count and latest uploaded tag:

ANDROID
- momentic: 3 tags (latest 1.2.0)
- other: 1 tag (latest v1)
IOS
- momentic: 1 tag (latest 2.0.0)

With --channel <channel>, the command prints the newest-first tags for that channel under each platform heading:

ANDROID
- momentic:
  - 1.2.0
  - 1.1.0
  - 1.0.0
IOS
- momentic:
  - 2.0.0

With --platform <platform>, only the requested platform is shown.

npx momentic-mobile assets list

Options

string

Channel to show tags for. When omitted, the command prints the channel summary view instead of tags.

string

Filter results to a specific mobile platform. One of android or ios.

string

Case-insensitive substring filter applied to tag names when listing a channel. For example, --tag-filter 1.2 matches any tag that contains the text 1.2.

boolean

Emit machine-readable JSON output instead of text.

Output

With --json, summary mode (no --channel) returns a platforms array, each with its channels, tag counts, and the latest uploaded tag:

{
  "platforms": [
    {
      "platform": "ANDROID",
      "channels": [
        {
          "channel": "momentic",
          "tagCount": 3,
          "latestTag": "1.2.0",
          "latestUploadedAt": "2026-04-20T17:53:07.049Z"
        }
      ]
    },
    {
      "platform": "IOS",
      "channels": [
        {
          "channel": "momentic",
          "tagCount": 1,
          "latestTag": "2.0.0",
          "latestUploadedAt": "2026-04-08T23:37:20.541Z"
        }
      ]
    }
  ]
}

Tag list mode (with --channel <channel>) returns the channel name and a platforms array whose tags are ordered newest-first:

{
  "channel": "momentic",
  "platforms": [
    {
      "platform": "ANDROID",
      "tags": [
        {
          "tag": "1.2.0",
          "md5": "qrNr9GyYYmx4P6+ZwLcooQ==",
          "uploadedAt": "2026-04-20T17:53:07.049Z"
        },
        {
          "tag": "1.1.0",
          "md5": "oE9fZ8whKPWXbyaFWDM4BA==",
          "uploadedAt": "2026-04-01T12:00:00.000Z"
        }
      ]
    }
  ]
}

`upload`

Upload a mobile asset to the Momentic dashboard. After upload, the asset is available in both the interactive editor and in test runs. Supported formats: Android APK (.apk) and iOS .app directory (development build). See iOS app setup for building a testing-ready .app.

npx momentic-mobile assets upload <file> --channel <channel> --tag <tag>

Uploaded assets are immutable: a (channel, tag) can only be re-uploaded with identical bytes. To publish a new build, upload it under a new tag (or delete the existing tag first). When --tag is omitted, a tag is generated for you and printed in the command output. A test that omits the tag, or uses the reserved tag latest, resolves to the most recently uploaded asset in the channel.

Arguments

string

required

Path to the asset to upload. Must be an .apk file or an .app directory.

Options

string

required

Release channel for the asset, such as staging or dev. This name affects how the asset will be referenced by tests. Channels cannot be renamed after creation.

string

Version label within the channel, a semantic version such as 0.0.1. When omitted, a tag is autogenerated and printed in the command output. latest is reserved and cannot be used as a tag; tests that reference latest (or omit the tag) resolve to the most recently uploaded asset in the channel.

string

Floating alias to move to this build, such as nightly or stable. Aliases are per-platform and move on each upload, while the underlying tagged bytes stay immutable, so a test referencing the alias always resolves to the most recently aliased asset. latest is reserved and cannot be used as an alias.

`download`

Download an APK from the Momentic dashboard to the local machine.

npx momentic-mobile assets download --channel <channel> --tag <tag>

Arguments

string

Optional path to download the asset to. Can be a directory or a file path. If omitted, the command uses the current working directory. If a directory is provided, the file is named <channel>-<tag>.apk.

Options

string

required

Release channel for the asset to download.

string

required

Version label within the channel to download.

`delete`

Delete a previously uploaded mobile asset. The command prompts for confirmation before deleting.

npx momentic-mobile assets delete --channel <channel> --tag <tag> --platform <platform>

Options

string

required

Release channel of the asset to delete.

string

required

Version label of the asset to delete within the channel.

string

required

Platform of the asset to delete. One of android or ios.

Examples

List the most recent tags for the staging channel as JSON:

npx momentic-mobile assets list --channel staging --json

Upload a staging APK tagged 1.2.0:

npx momentic-mobile assets upload ./app-staging.apk --channel staging --tag 1.2.0

Upload a build and move the nightly alias to it so tests referencing nightly resolve to this build:

npx momentic-mobile assets upload ./app-staging.apk --channel staging --tag 1.2.0 --alias nightly

Download a specific tag into the current directory:

npx momentic-mobile assets download --channel staging --tag 1.2.0

Delete a specific asset:

npx momentic-mobile assets delete --channel staging --tag 1.2.0 --platform android

Overview

momentic CLI

momentic-mobile CLI

qa CLI

momentic-mobile assets

`list`

Options

Output

`upload`

Arguments

Options

`download`

Arguments

Options

`delete`

Options

Examples

​list

​Options

​Output

​upload

​Arguments

​Options

​download

​Arguments

​Options

​delete

​Options

​Examples

`list`

Options

Output

`upload`

Arguments

Options

`download`

Arguments

Options

`delete`

Options

Examples