Skip to content

Installation

macOS (Apple Silicon) — prebuilt binary, always the latest release:

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

Windows and Linux CLI builds are on the way.

Check what your machine can drive:

Terminal window
tapstep doctor # adb / Xcode / browsers / code CLI
tapstep list-devices # browsers, Android devices, iOS simulators

No Chrome? --browser managed downloads a pinned Chromium into ~/.tapstep/browsers on first use — reproducible runs, same as CI.

Grab an installer from the download page:

  • macOS (Apple Silicon) — .dmg. First launch: right-click → Open (signed for auto-updates, not Apple-notarized, so Gatekeeper asks once). It keeps itself on the latest version after that.
  • Windows (x64) — .exe. Not code-signed yet, so SmartScreen warns once — choose “More info → Run anyway”.
  • Linux (x64) — .AppImage or .deb.

macOS auto-updates today; Windows and Linux are manual downloads for now.

  • Web — Chrome family via CDP, Firefox via WebDriver BiDi.
  • Android — devices and emulators via adb.
  • iOS — simulators via XCUITest (macOS only).