CLI - App Automate (Beta)

BrowserStack App Automate allows you to manage your app testing on our cloud-based infrastructure by providing full integration with the command-line interface (CLI). Follow the steps below to setup BrowserStack CLI on your machine:

1. Download the BrowserStack binary for CLI:
   • OS X 32-bit (10.7 and above)
   • OS X 64-bit (10.7 and above)
   • Linux 32-bit
   • Linux 64-bit
   • Windows 32-bit (XP and above)
   • Windows 64-bit (XP and above)
2. Open your terminal and navigate to the folder containing the BrowserStack CLI binary.
3. Make the BrowserStack CLI executable by running the following command:
• For MAC and Linux machines:

chmod +x browserstack

Give your users a seamless experience by testing on 3000+ real devices. To get started, run the command below to explore the list of available options.

USAGE

$ ./browserstack [commands] [flags]

COMMANDS

app-automate    Automated mobile app testing on Real Mobile devices
authenticate    Set/Update your BrowserStack credentials
help            Help about any command
update          Update browserstack-cli to the latest version
version         Print the version number of BrowserStack CLI

FLAGS

    --config  Config file for your tests. Default: $HOME/.browserstack-cli.yaml
-h, --help    help for browserstack

To know more about any specific command, use the help flag as shown below

./browserstack [command] --help

Before you can upload an app or manage your test executions, you first need to authenticate yourself with your BrowserStack username and access-key. You can view your credentials on App Automate dashboard or Account Summary page

USAGE

$ ./browserstack authenticate [flags]

FLAGS

--username    To identify you as a unique user on BrowserStack account. You can fetch the info from https://www.browserstack.com/accounts/settings
--access-key  Private BrowserStack key associated with your account. You can fetch the info from https://www.browserstack.com/accounts/settings
-h, --help    Help for authenticate

EXAMPLE

./browserstack authenticate --username=your_username --access-key=your_access_key

Once authenticated, you can explore CLI for App Automate using the command below :

./browserstack app-automate

apps         Manage your uploaded mobile apps on BrowserStack
testsuite    Manage your TestSuite for different Frameworks (Espresso/XCUITest/EarlGrey)
espresso     Run your Espresso mobile app tests
xcuitest     Run your XCUITest mobile app tests
appium       View and manage your appium tests executed on BrowserStack real devices.
plan-status  Get plan details - Number of parallels allowed, currently running and queued
devices      List of all Devices available for Testing