Browserstack logo
  • Live for Teams
  • Pricing
  • Manual Testing

    Live

    Cross-browser testing

    Bug Capture

    Report & resolve bugs faster

    Accessibility Testing

    Test WCAG compliance

    Requestly

    HTTP interceptor & mocking

    Test Automation

    Automate

    Browser automation grid

    Automate TurboScale

    Automation on your Cloud

    Accessibility Automation

    Automate WCAG testing

    Percy

    Visual testing & review

    Low Code Automation

    Automation without coding

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Reporting & Analytics

    Monitor & optimize all tests

    Empower teams with BrowserStack for Enterprise →

    Tools: SpeedLab , Screenshots , Responsive

    Manual Testing

    App Live

    Real device testing

    App Accessibility Testing

    Test WCAG compliance

    Test Automation

    App Automate

    Real device automation cloud

    App Percy

    Visual testing for mobile apps

    Management & Optimization

    Test Management

    Unify & track all test cases

    Test Reporting & Analytics

    Monitor & optimize all tests

    Empower teams with BrowserStack for Enterprise →

    • Documentation
    • Support
    • Status
    • Release Notes
    • Open Source
    • Events
    • Meetups
    • Champions
  • Live for Teams
  • Pricing
  • Sign in
  • Free Trial
  • Manual Testing
  • Live
    Manual cross-browser testing
  • Accessibility Testing
    Super app to find & report issues
  • Test Automation
  • Automate
    Browser automation grid
  • Percy
    Visual testing & review
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Reporting & Analytics
    Monitor & optimize all tests
  • For Teams
  • Enterprise
  • Manual Testing
  • App Live
    Manual real device testing
  • App Accessibility Testing
    Test WCAG compliance
  • Test Automation
  • App Automate
    Real device automation cloud
  • App Percy
    Visual testing for mobile apps
  • Management & Optimization
  • Test Management
    Unify & track all test cases
  • Test Reporting & Analytics
    Monitor & optimize all tests
  • For Teams
  • Enterprise
  • Documentation
  • Support
  • Status
  • Release Notes
  • Open Source
  • Events
  • Champions
  • Documentation
  • Appium
  • Espresso
  • XCUITest
  • EarlGrey
  • Test dev environments
  • Speed up your test suite
  • References
  • Features
  • Browsers & Devices
  • Emulator vs Real Device
  • Simulator vs Real Device
  • Security
  • Debugging
  • Device Features
  • Status
    Home Documentation App Automate Browserstack Cli

    CLI - App Automate (Beta)

    The CLI provides a set of simple commands to upload apps, manage your test executions and much more. This guide will help you setup and use BrowserStack CLI for your automated mobile app testing.

    Introduction

    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

    Getting Started

    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

    Authenticate

    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
    

    In This Article

    • Introduction
    • Getting Started
    • Authenticate
    Related Articles

    Capabilities

    Local Testing

    Rest API

    Jenkins

    PRODUCTS

    • Live
    • Automate
    • Automate TurboScale
    • Percy
    • App Live
    • App Automate
    • App Percy
    • Test Management
    • Test Reporting & Analytics
    • Accessibility Testing
    • Accessibility Automation
    • App Accessibility Testing
    • Low Code Automation
    • Bug Capture
    • Requestly

    WHY BROWSERSTACK

    • Customers
    • Case Studies
    • Browsers & Devices
    • Enterprise
    • Data Centers
    • Real Device Features
    • Security

    RESOURCES

    • Support
    • Status
    • Release Notes
    • Blog
    • Events
    • Community
    • Meetups
    • Champions
    • Guide
    • Partners
    • Find a partner
    • Trust Center
    • Test University

    COMPANY

    • About Us
    • Careers
    • Open Source
    • Press
    • Newsletter
    Browserstack logo
    SOCIAL
    twitter social link facebook social link linkedin social link youtube social link instagram social link discord social link
    Contact Us

    More Resources

    Cross Browser Testing Selenium Testing Test Management Emulators vs Real Device Mobile App Testing

    Test on Device

    Test on iPad Test on Galaxy Test In IE Test on Android Test on iOS Mobile Emulators Test on Right Devices

    Tools

    SpeedLab Screenshots Responsive Nightwatch.js
    discord social link
    Contact Us

    © 2025 BrowserStack. All rights reserved.

    • Terms of Service
    • Privacy Policy
    • Cookie Policy
    • Sitemap