Установка

CLI

Один статический бинарник, всегда последний релиз. В каждом архиве лежит только tapstep — положите его в любую папку из PATH.

macOS (Apple Silicon) — подписан и нотаризован, Gatekeeper не спрашивает:

curl -fsSL https://s3.tapstep.dev/tapstep-cli/tapstep-latest-macos-arm64.tar.gz | tar -xz
sudo mv tapstep /usr/local/bin/

Linux (x86_64):

curl -fsSL https://s3.tapstep.dev/tapstep-cli/tapstep-latest-linux-x86_64.tar.gz | tar -xz
sudo mv tapstep /usr/local/bin/

Windows (x64): скачайте tapstep-latest-windows-x86_64.zip, распакуйте tapstep.exe в папку из PATH (например, %LOCALAPPDATA%\tapstep\bin).

Вход

Всё, кроме doctor, update, login/logout, bugreport, privacy и skill refresh, требует аккаунт — один раз. Войдите, и дальше tapstep работает офлайн:

tapstep login                              # откроет браузер (SSO)
tapstep login --token tapstep_pat_…        # CI: персональный токен

В CI вместо login можно задать переменную окружения TAPSTEP_TOKEN. У десктопа та же стена: при первом запуске появится экран входа.

Проверьте машину

tapstep doctor        # adb / Xcode / браузеры / code CLI
tapstep list-devices  # браузеры, устройства Android, симуляторы iOS

Веб-сценарии гоняют браузер, который у вас уже есть — Chrome, Chromium, Edge, Brave, Opera, Vivaldi, Yandex или Firefox. Нет Chrome? --browser managed скачает прибитый Chromium в ~/.tapstep/browsers при первом запуске — воспроизводимые прогоны, как в CI.

Держите в актуальном состоянии

tapstep update           # самообновление до последнего релиза
tapstep update --check   # только сообщить, что нового
tapstep skill install    # скилл агента для Claude Code / Codex / Gemini CLI / Cursor / OpenCode

tapstep update заменяет бинарник на месте на всех трёх платформах. skill install учит вашего кодового агента формату сценариев и CLI — см. AI-агенты.

Desktop

Возьмите установщик со страницы загрузки:

macOS (Apple Silicon) — .dmg, подписан и нотаризован; открывается без предупреждений.
Windows (x64) — .exe. Пока без code-sign, поэтому SmartScreen ругнётся один раз — нажмите «Подробнее → Выполнить в любом случае».
Linux (x64) — .AppImage или .deb.

Приложение само держится на последней версии на macOS, Windows и Linux (AppImage; установку из .deb обновляют вручную). При первом запуске попросит войти — тот же аккаунт, что и в CLI.

Платформы

Web — семейство Chrome через CDP, Firefox через WebDriver BiDi.
Android — устройства и эмуляторы через adb.
iOS — симуляторы через XCUITest (только macOS).
Расширения VS Code — заголовок vscode: в сценарии поднимает установленный VS Code с вашим .vsix и рабочей областью-фикстурой; testspace’ы живут в config.yaml.
Десктоп-приложения — Tauri/webview-приложения со встроенным мостом tapstep, драйвер --driver app — см. Тестирование десктоп-приложений.
Только API — сценарии device: none из шагов request:, вообще без устройства — см. API-тестирование.