ZeptapDocs
Commands

run

Run several steps in one call, from arguments, a file or stdin. Stops at the first failure.

Usage

zeptap run <step>...
zeptap run -f <file>
zeptap run -f -

Options

OptionDescription
<step>One command line without zeptap, such as "tap --text Reels". Quote each step
-f, --file <path>Read steps from a file, one per line. - reads stdin
--continue-on-errorRun every step even after one fails
--shots lastSave a screenshot only after the last step (default)
--shots allSave a screenshot after every step
--lookPrint the screen's text after the last step

-l, -p and --settle-ms apply to every step that doesn't set its own. Also takes --json.

Details

  • Steps run in order and stop at the first failure unless --continue-on-error is set. When a step fails, run saves a screenshot so you can see where it stopped.
  • Blank lines and lines starting with # are skipped. Each step is split like a shell would: quotes group words, and a backslash escapes.
  • A step may start with zeptap; it's dropped.
  • run, mcp, doctor, skill, acquire and release can't be steps.
  • The output has one line per step ([2] tap --text Reels: ok - ...), then the last step's result. With --json, data.steps holds each step's full result.
  • The exit code is the first failure's, or 0.
  • Use run for sequences the agent has already worked out. It still decides what to do between runs.

Examples

$ zeptap run -l 7 "open Instagram" "tap --text Reels" "wait 3000" "flick up" "wait 3000"
$ zeptap run -l 7 -f warmup.steps --continue-on-error
$ printf 'tap @t3\nwait 800\ntype hello\n' | zeptap run -l 7 -f - --look

A steps file:

warmup.steps
# Watch a few Reels
open Instagram
tap --text Reels
wait 4000
flick up
wait 4000
flick up

On this page