Configuration and preferences
Test Companion lets you control how it behaves, how it interacts with your project files, and how it connects to BrowserStack’s cloud testing infrastructure.
This page gives you an overview of every available setting, so you can match Test Companion to your testing environment and workflow. Settings apply to your own Test Companion. Each teammate configures their own. This guide explains what each setting does, when to use it, and how your choices change Test Companion’s behavior.
How to open settings
To open the Settings panel:
Click the Settings gear icon at the top-right corner of the Test Companion panel.

Open the tab you need and make your changes, then click Save.

Settings tabs
The Settings panel is organized into tabs in the left sidebar. Each tab links to its detailed guide:
- General settings: Adjust language preferences, authentication settings, and telemetry options.
- Chat settings: Choose an interaction mode, Agent or Plan, and set system instructions for your test automation environment.
- Feature settings: Set the test case template, type, priority, and language defaults, and manage checkpoints, notifications, GitHub integration, Electron testing, and repo onboarding.
- Auto-approve settings: Control the actions that Test Companion can perform without prompting for your permission.
- Browser settings: Choose the browser, and set the viewport size, browser profile behavior, and headless mode for browser-based tasks.
- Mobile settings: Set Android and iOS session overrides, network and orientation defaults, the device used for authoring, and diagnostics captures for mobile sessions.
- Proxy and local settings: Configure local testing, cloud local testing, tunnel routing, and proxy settings so Test Companion can reach BrowserStack from your network.
- Plan and usage: View your current plan, track your usage allowance, learn when to start a new task in a long chat, and find support contacts.
- Info and support: Check the Test Companion version, open the documentation, contact support, report a bug, or schedule a demo.
Choose where to start
If you are new to Test Companion, start by exploring the Chat settings and Auto-approve settings. These two tabs significantly influence how the AI interacts with you on a daily basis. The Chat settings determine whether the AI asks for confirmation at each step or operates independently, while the Auto-approve settings control what the AI can do without your explicit approval.
Next, set the viewport size in the Browser settings to match your target devices.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!