Waldo provides fast, reliable, and maintainable testing for the most critical flows in your app. Waldo CLI is a command-line tool which allows you to interact with Waldo in several useful ways:
- Authenticate user access to Waldo with an API token.
- Upload an iOS or Android build to Waldo for processing. See here and here for more details.
- Trigger a run of of one or more test flows for your app. See here for more details.
Type waldo help
to see all that Waldo CLI can do for you!
Note: If you intend to use Waldo CLI from a CI script, please refer to the next section — Installation for CI — for instructions.
To install Waldo CLI, simply download and execute the installer script:
TOKEN=u-xxxx bash -c "$(curl -fLs https://github.com/waldoapp/waldo-go-cli/raw/master/install.sh)"
The script attempts to install Waldo CLI to ~/.waldo/bin
.
If you set the TOKEN
environment variable to the value of your API token, the installer script will automatically run the waldo auth
command upon successful installation of Waldo CLI. You can retrieve your API token by visiting the “Profile” tab of your Waldo account settings (https://app.waldo.com/settings/profile).
You can verify that you have installed Waldo CLI correctly with the which waldo
and waldo help
commands.
If you ever need to uninstall Waldo CLI, simply delete the binary at ~/.waldo/bin/waldo
.
To install Waldo CLI, simply navigate to the latest release, download the appropriate waldo
executable for your machine (either waldo-windows-x86_64.exe
or waldo-windows-arm64.exe
), and install it as waldo.exe
to a location known to %PATH%
.
You can verify that you have installed it correctly with the waldo help
command.
If you ever need to uninstall Waldo CLI, simply delete the executable from the install location.
Note: If you intend to use Waldo CLI interactively, please refer to the previous section — Installation — for instructions.
To install Waldo CLI, simply download and execute the installer script:
bash -c "$(curl -fLs https://github.com/waldoapp/waldo-go-cli/raw/master/install-waldo.sh)"
By default, the script installs Waldo CLI to /usr/local/bin
.
If you wish to install Waldo CLI to a different location, simply set the WALDO_CLI_BIN
environment variable before invoking the installer script:
WALDO_CLI_BIN=/path/to/binary bash -c "$(curl -fLs https://github.com/waldoapp/waldo-go-cli/raw/master/install-waldo.sh)"
You can verify that you have installed Waldo CLI correctly with the which waldo
and waldo help
commands.
If you ever need to uninstall Waldo CLI, simply delete the executable from the install location.
To install Waldo CLI, simply navigate to the latest release, download the appropriate waldo
executable for your machine (either waldo-windows-x86_64.exe
or waldo-windows-arm64.exe
), and install it as waldo.exe
to a location known to %PATH%
.
You can verify that you have installed it correctly with the waldo help
command.
If you ever need to uninstall Waldo CLI, simply delete the executable from the install location.