Tricentis Mobile Agent CLI

A Command-Line Interface (CLI) is a text-based user interface that allows you to run programs, manage computer files, and interact with the computer. For faster access, you can start and operate Tricentis Mobile Agent from the CLI.

The following sections describe the list of commands you can use:

Start

The start command starts a local Agent. Before the CLI attempts to start the Agent, it checks that no other Agent process is running in the background. The CLI process continues to run until the Agent is terminated or shut down.

tricentis-mobile-agent start

To start Appium on a specific port on any operating system, such as Mac, Windows, or Linux, use the following command:

tricentis-mobile-agent start --appium-port=<appiumPort>

Execute Appium driver script

To help you automate tasks, the --execute-appium-driver-script command lets you run multiple Appium commands together in a script.

To run a script with Appium, use this command:

tricentis-mobile-agent start --execute-appium-driver-script

Running this command exposes your system under test (SUT) to remote code execution. Since Tricentis Mobile Agent doesn't check your script before running it, this could lead to potential security issues from malicious content, including unauthorized SUT access, as well as other unexpected behaviors such as data corruption and application crashes.

Fork

Use the -f or --fork command to execute several tasks independently of each other. The CLI process forks when the Agent process starts. The CLI doesn't wait for the Agent to terminate, and the default namespace isn't appended. This command is useful for continuous integration and continuous deployment (CI/CD) and various configurations. 

tricentis-mobile-agent start --fork

External connectivity

By default, Agent starts its gRPC and web servers and binds them to localhost.

To instruct the Agent to bind its gRPC to a different host and port, use the --grpc-address command.

tricentis-mobile-agent start --grpc-address <IP address>:<port>

To instruct the Agent to bind its web server to a different host and port, use the --rest-address command.

tricentis-mobile-agent start --rest-address <IP address>:<Port>

Connect

To connect to an Agent and print its version, use the connect command.

tricentis-mobile-agent connect