Команды

Запуск

tapstep test <flow.yaml | dir> [--driver web|android|ios] [-v]
tapstep test app.flow.yaml --headed        # реальное окно браузера
tapstep test flows/ -c                     # watch-режим: перезапуск при сохранении
tapstep live <flow.yaml> [--port 7878]     # интерактивный live-просмотр в браузере

--browser chrome|chromium|edge|brave|opera|vivaldi|yandex|firefox|managed выбирает браузер (managed = прибитый Chromium в ~/.tapstep/browsers). --viewport WxH, --locale en-US настраивают браузер. -e KEY=VAL переопределяет переменные сценария; --env-file FILE подгружает дополнительные dotenv-файлы поверх автоматически найденного .env; --env-set NAME применяет именованный набор из блока environments: конфига — см. config.yaml.

Инспекция и инструменты

tapstep inspect [target] [--measure]   # компактный снимок экрана
tapstep list-devices                   # браузеры, устройства Android, симуляторы iOS
tapstep start-device android|ios       # поднять эмулятор / симулятор
tapstep doctor                         # проверить внешние инструменты каждого драйвера
tapstep privacy install                # локальная модель маскирования PII (~918 МБ)
tapstep privacy status                 # privacy-режим: включён? модель установлена?
tapstep init [path] [--samples] [--agents]  # стартовый сценарий / примеры / настройка агентов
tapstep skill install                  # скилл агента для Claude Code / Codex / Gemini
tapstep mcp                            # stdio MCP-сервер для AI-клиента
tapstep appmeta <apk|ipa|app>          # метаданные сборки как JSON
tapstep bugreport [path]               # zip с локальной диагностикой для issue
tapstep update [--check]               # самообновление до последнего релиза

Синхронизация с бэкендом

tapstep login [--token tapstep_pat_…] [--api <url>]   # SSO в браузере; --token для 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-ранов

tapstep login по умолчанию выполняет вход через браузер (SSO); --token сохраняет токен бэкенда (для CI). Все команды, кроме login, logout, doctor, bugreport, serve-run, update и privacy, требуют предварительного входа.