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
| Option | Description |
|---|---|
<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-error | Run every step even after one fails |
--shots last | Save a screenshot only after the last step (default) |
--shots all | Save a screenshot after every step |
--look | Print 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-erroris set. When a step fails,runsaves 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,acquireandreleasecan't be steps.- The output has one line per step (
[2] tap --text Reels: ok - ...), then the last step's result. With--json,data.stepsholds each step's full result. - The exit code is the first failure's, or 0.
- Use
runfor 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 - --lookA steps file:
# Watch a few Reels
open Instagram
tap --text Reels
wait 4000
flick up
wait 4000
flick up