Skip to main content
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

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 ... (more options) button at the top-right corner of the Test Companion panel, then select Settings.

More options menu showing the Settings option

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

Settings panel open on the General tab, with the Save and Cancel buttons in the top-right

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, Default or Guided, and set system instructions for your test automation environment.
  • Feature settings: Choose a test case format, Default or BDD, and manage checkpoints, notifications, and Electron testing support.
  • Auto-approve settings: Control the actions that Test Companion can perform without prompting for your permission.
  • Browser settings: 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, and diagnostics captures for mobile sessions.
  • Proxy and local settings: Configure local testing, tunnel routing, and proxy settings so Test Companion can reach BrowserStack from your network.
  • Terminal settings: Configure how Test Companion reuses your IDE’s integrated terminal.
  • Plan and usage: View your current plan, track your usage allowance, 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





Thank you for your valuable feedback

Is this page helping you?

Yes
No

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!

Talk to an Expert
Download Copy Check Circle