PantoQA CLI

PantoQA CLI is a Python package for running QA flows against Android or iOS apps using natural-language prompts. It connects to the PantoQA service over WebSocket and can drive a locally connected device via the PantoQA bridge or manage remote device sessions.

Project overview

This repository packages the pantoqacli command and includes a skill definition used by the PantoQA agent tooling:

• pantoqacli — command-line entry point for authentication, QA execution, bridge inspection, and remote device management
• skills/pantoqa-agent/SKILL.md — exported skill metadata for agent integrations

Installation

Install from the project root with pip:

python -m pip install -e .

Or install the package from PyPI if available:

python -m pip install pantoqacli

For local developer setup with optional tooling:

python -m pip install -e .[dev]

CLI entry point

After installation, the package exposes:

pantoqacli --help

You can also check the installed version:

pantoqacli --version

Authentication

Most commands require a token. The CLI resolves it in this order:

1. --token argument
2. PANTOQA_TOKEN environment variable
3. ~/pantoqa-agent/.token

Log in to create the token file:

pantoqacli login

Verify the configured key:

pantoqacli test-auth

The alias below is also supported:

pantoqacli auth

Local bridge setup

For local device testing, the bridge must be running and a device must be attached.

Start the bridge:

pantoqa_bridge

Check bridge health:

pantoqacli bridge status

List connected devices:

pantoqacli bridge devices

The serial_no returned by bridge devices is what you pass to --device-serial-no in a QA run.

Running QA prompts

Run a single prompt:

pantoqacli run \
  --prompt "Open Settings app"

Run multiple prompts sequentially in one session:

pantoqacli run \
  --prompt "Open Settings" \
  --prompt "Enable Wi-Fi"

Common optional flags:

pantoqacli run \
  --base-url https://qa-app.getpanto.ai \
  --token "$PANTOQA_TOKEN" \
  --prompt "Open Settings" \
  --prompt "Enable Wi-Fi" \
  --platform android \
  --driver-type BRIDGE_V2 \
  --session-exe-type EXECUTE \
  --bridge-base-url http://127.0.0.1:6565 \
  --device-serial-no emulator-5554 \
  --xml-mode adb \
  --verbose

Bridge and remote device utilities

Inspect the bridge without running a prompt:

pantoqacli bridge status
pantoqacli bridge devices

Remote device lifecycle commands:

pantoqacli remote device start --base-url https://qa-app.getpanto.ai --token "$PANTOQA_TOKEN"
pantoqacli remote device status --session-id <session-id>
pantoqacli remote device preview --session-id <session-id>
pantoqacli remote device stop --timeout 10

Exporting the skill definition

This project includes a skill file that can be exported for agent usage:

pantoqacli export-skill

Development

Repository structure:

.
├── LICENSE
├── README.md
├── makefile
├── pyproject.toml
├── pantoqacli/
│   └── cli.py
├── docs/
└── skills/
    └── pantoqa-agent/
        └── SKILL.md

To run the package in editable mode for local development:

python -m pip install -e .

Notes

• run executes prompts over a WebSocket to the QA server.
• bridge commands talk to the local bridge service that performs device actions.
• Remote device commands are separate from local bridge execution and manage background remote sessions.
• If a bridge is not reachable or no device is available, do not attempt to run automated prompts against it.

License

This project is licensed under the MIT License. See LICENSE for details.