act

Hands a natural-language goal to the AI agent, which performs whatever taps, types, and scrolls are needed to accomplish it. Reach for act when the exact UI path is unknown or brittle; use a single tap/type when you already know the step. The simplified form takes the goal as a single string.

Parameters

Parameter	Type	Required	Description
`goal`	`string`	Yes	What the agent should accomplish.
`version`	`string`	No	AI action version to run with (e.g. `"2"`).
`cache`	`false`	No	Set to `false` to disable caching. The AI agent runs on every execution instead of replaying previously generated steps. V3 only.
`saveAs`	`string`	No	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	No	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Shorthand

Write a multi-word bare goal string inside a step list. Momentic reads it as AI action V3.

- Complete the new-user signup flow using a fresh email

New projects created by momentic-mobile init enable advanced.aiActionShorthand and preserve eligible multi-word V3 goals in the bare form. Existing projects without this setting write the canonical act: form. One-word goals remain under act:, registered mobile bare commands such as killApp keep their command meaning, and unknown one-word bare strings are rejected.

Examples

- act:
    goal: Add the cheapest in-stock item to the cart
    version: "2" # pin this step to a specific AI action version

Disable caching so the agent re-derives the flow on every run.

- act:
    goal: Open the most recent order and archive it
    cache: false

Overview

AI

Interactions

Device

Apps

Screen checks

Element checks

Visual

Network

Scripts

Files

Media

Waits

Control flow

Debugging

Parameters

Shorthand

Examples

​Parameters

​Shorthand

​Examples

​Related

Parameters

Shorthand

Examples

Related