Installation guide

Install the BrowserStack Test Companion extension to generate, automate, and fix test cases directly within your editor. You can install the extension automatically through your IDE or manually using a .vsix file.

The setup process has three main steps:

• Install the Extension
• Verify that the installation was successful
• Sign In to your BrowserStack account

Install the Extension

You can install the extension automatically through your IDE (recommended) or manually by downloading the .vsix file from the marketplace.

Install from the IDE

This is the simplest way to find and install extensions from within the IDE. Install the extension directly through the Visual Studio Code or Cursor interface. This ensures you receive automatic updates.

1. Open the Extensions view in your IDE.
   • Keyboard shortcut: Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS).
   • UI: Click the blocks icon in the Activity Bar.

   

2. In the search bar, type Test Companion.

   

3. Locate Test Companion extension in the results list, which will be published by BrowserStack.
4. Select Install.

Install from the marketplace

Manually install the extension using a .vsix file if you cannot connect to the official Visual Studio marketplace. This method is required for air-gapped machines, restricted networks behind firewalls, and IDE forks like Cursor or VSCodium.

This is a two-step installation process:

1. Download the vsix file.
2. Install the vsix file.

Download the vsix file

Download the latest version of the VSIX for your specific environment using the links below:

Install the vsix file

1. Navigate to the marketplace page for your IDE.

2. On the marketplace page, click Download.

   

3. Open the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on macOS) in your IDE.

4. Type Install from VSIX and select the command Extensions: Install from VSIX… from the menu.

   

5. Navigate to your download location and select the .vsix file you just downloaded.

The IDE installs the extension automatically.

Verify the Installation

Once installed, you can verify that Test Companion is active in two ways.

Method 1: Check the activity bar

The fastest way to check is to look for the Test Companion icon in the IDE Activity Bar (the primary sidebar/topbar on the left).

Method 2: Check the Extensions list

You can also confirm the installation in your list of extensions.

1. Navigate to the Extensions view:
   • Click the Extensions icon in the Activity Bar.
   • Or, use the Command Palette (Ctrl+Shift+P) and type View: Extensions.
2. In the search bar for your Installed extensions, type Test Companion.
3. If the installation was successful, it will appear in the list.

Sign in to BrowserStack

The final step is to connect the extension to your BrowserStack account.

1. Click the Test Companion icon in the Activity Bar to open the Test Companion panel.

   

2. In the panel, click the Sign in with BrowserStack button.
3. Your default web browser will open, asking you to authorize the extension.
4. Follow the prompts to sign in. If you do not have an account, you can create one here.

After you sign in, your browser will redirect you back to your IDE. The Test Companion panel will now show your user information and be ready for use.

You are all set! Congratulations, Test Companion is now installed and configured.

You can start exploring what’s next:

• Generate Test Cases: Write test cases from requirements using AI.
• Automate Tests with AI: Convert manual test cases into executable automation scripts.
• Fix Failed Tests: Debug and fix test failures using Test Reporting & Analytics.