act - Momentic

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

Momentic writes the canonical act: form when it saves the test. Set advanced.aiActionShorthand to true to write eligible multi-word V3 goals in the bare 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

⌘I