Commands

Run

tapstep test <flow.yaml | dir> [--driver web|android|ios] [-v]
tapstep test app.flow.yaml --headed        # real browser window
tapstep test flows/ -c                     # watch mode: re-run on save
tapstep live <flow.yaml> [--port 7878]     # interactive live view in the browser

--browser chrome|chromium|edge|brave|opera|vivaldi|yandex|firefox|managed picks the web browser (managed = pinned Chromium in ~/.tapstep/browsers). --viewport WxH, --locale en-US tune the browser. -e KEY=VAL overrides flow variables; --env-file FILE loads extra dotenv files over the auto-discovered .env; --env-set NAME applies a named set from the config’s environments: — see config.yaml.

Inspect & tooling

tapstep inspect [target] [--measure]   # compact screen snapshot
tapstep list-devices                   # browsers, Android devices, iOS simulators
tapstep start-device android|ios       # boot an emulator / simulator
tapstep doctor                         # check each driver's external tools
tapstep privacy install                # on-device PII masking model (~918 MB)
tapstep privacy status                 # privacy mode: enabled? model installed?
tapstep init [path] [--samples] [--agents]  # starter flow / samples / agent setup
tapstep skill install                  # agent skill for Claude Code / Codex / Gemini
tapstep mcp                            # stdio MCP server for an AI client
tapstep appmeta <apk|ipa|app>          # parsed build metadata as JSON
tapstep bugreport [path]               # zip local diagnostics for an issue
tapstep update [--check]               # self-update to the latest release

Backend sync

tapstep login [--token tapstep_pat_…] [--api <url>]   # browser SSO; --token for CI
tapstep logout
tapstep push <flow.yaml> --project <id> [--scenario <id>]
tapstep pull <scenario-id> [--output <file>]
tapstep scenarios --project <id>
tapstep run <flow.yaml> --project <id> [--live] [--video]
tapstep build push <apk|ipa> --project <id>
tapstep build list --project <id>
tapstep serve-run [--http <addr>] [--api <url>] [--video]   # managed-run engine

tapstep login signs in via browser SSO by default; --token saves a backend token instead (CI). Every command except login, logout, doctor, bugreport, serve-run, update, and privacy requires a prior sign-in.