# run

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

Source: https://zeptap.com/docs/cli/commands/run



## Usage [#usage]

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

## Options [#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 [#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 [#examples]

```sh
$ 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:

```sh title="warmup.steps"
# Watch a few Reels
open Instagram
tap --text Reels
wait 4000
flick up
wait 4000
flick up
```
