Skip to content
tapsteptapsteptapstepDocs

Installation

CLI

Section titled “CLI”

One static binary, always the latest release. Every archive contains just tapstep — put it anywhere on your PATH.

macOS (Apple Silicon) — signed and notarized, no Gatekeeper prompt:

Terminal window
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):

Terminal window
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): download tapstep-latest-windows-x86_64.zip, unzip tapstep.exe into a folder on your PATH (for example %LOCALAPPDATA%\tapstep\bin).

Sign in

Section titled “Sign in”

Everything except doctor, update, login/logout, bugreport, privacy and skill refresh needs an account — once. Sign in, and tapstep works offline after that:

Terminal window
tapstep login                              # opens the browser (SSO)
tapstep login --token tapstep_pat_…        # CI: a personal access token

In CI you can also set TAPSTEP_TOKEN in the environment instead of running login. The desktop app has the same wall: first launch shows a sign-in screen.

Check the machine

Section titled “Check the machine”
Terminal window
tapstep doctor        # adb / Xcode / browsers / code CLI
tapstep list-devices  # browsers, Android devices, iOS simulators

Web flows drive a browser you already have — Chrome, Chromium, Edge, Brave, Opera, Vivaldi, Yandex, or Firefox. No Chrome? --browser managed downloads a pinned Chromium into ~/.tapstep/browsers on first use — reproducible runs, same as CI.

Keep it current

Section titled “Keep it current”
Terminal window
tapstep update           # self-update to the latest release
tapstep update --check   # only report what's new
tapstep skill install    # agent skill for Claude Code / Codex / Gemini CLI / Cursor / OpenCode

tapstep update replaces the binary in place on all three platforms. skill install teaches your coding agent the flow format and CLI — see AI agents.

Desktop

Section titled “Desktop”

Grab an installer from the download page:

  • macOS (Apple Silicon) — .dmg, signed and notarized; opens without warnings.
  • Windows (x64) — .exe. Not code-signed yet, so SmartScreen warns once — choose “More info → Run anyway”.
  • Linux (x64) — .AppImage or .deb.

The app keeps itself on the latest version on macOS, Windows and Linux (the AppImage; a .deb install is re-downloaded by hand). First launch asks you to sign in — same account as the CLI.

Platforms

Section titled “Platforms”
  • Web — Chrome family via CDP, Firefox via WebDriver BiDi.
  • Android — devices and emulators via adb.
  • iOS — simulators via XCUITest (macOS only).
  • VS Code extensions — a vscode: flow header boots the installed VS Code with your .vsix and a workspace fixture; testspaces live in config.yaml.
  • Desktop apps — Tauri/webview apps that embed the tapstep bridge, driven with --driver app — see Testing desktop apps.
  • API only — device: none flows made of request: steps, no device at all — see API testing.