---
title: "VS Code, Cursor and Windsurf | Proxy Mail QA"
description: "Proxy Mail QA for VS Code: make test addresses in the sidebar, copy the code or link from the email, wait for one in the status bar and insert Playwright or Cypress tests. Also in Cursor, Windsurf and Qoder."
url: https://proxymail.qa/docs/vscode
---

# VS Code, Cursor and Windsurf

Proxy Mail QA for VS Code puts your test addresses beside your code. Make an address in the sidebar, sign up with it in your app, and the code or link from the email shows up in the sidebar, ready to copy. Choose **Wait for code** and the code shows in the status bar as well. It also inserts Playwright and Cypress tests for sign-up, password reset and magic links.

It’s on the Visual Studio Marketplace for VS Code, and on Open VSX for Cursor, Windsurf, Qoder and other editors built on VS Code.

### Step 1: Install it

In VS Code, open Extensions, search for **Proxy Mail QA** and choose **Install**. In Cursor, Windsurf or Qoder, the same search finds it on Open VSX.

### Step 2: Add a project

Create an [API key](https://proxymail.qa/docs/api-keys) for the project. Open the Proxy Mail QA view in the activity bar, choose **Add API key** and paste the key.

VS Code keeps the key in its secret storage. The sidebar never sees it: it gets the addresses and codes, and asks VS Code to do the rest.

### Step 3: Make a test address

Under **New address**, pick a country, an age band and an environment if you like, and whether to make a password. Choose **New address**.

The address, the test person’s details and the password are shown with a copy button each. The password is shown only until you choose **Done**, so copy it first.

### Step 4: Wait for the code

Sign up in your app with the address, then choose **Wait for code**. The status bar shows “Waiting for code…” for up to two minutes. When the email arrives, the code shows in the status bar and a notification offers **Copy code**.

## The sidebar

| Part             | What it does                                                                                      |
| ---------------- | ------------------------------------------------------------------------------------------------- |
| Project          | Switches between the projects you’ve added                                                        |
| New address      | Makes a test address with a test person, for the country, age band and environment you pick       |
| Codes and links  | Your live addresses, newest first, each with the newest code, link or coupon from its email       |
| An address’s row | Open it for the test person’s details, each with Copy, and **Wait for code** or **Wait for link** |
| A link           | **Copy link**, or open it in your browser                                                         |

Each kind of email keeps its colour, as in the app: codes, sign-in links, reset links, invites and coupons. The list refreshes every 15 seconds while the sidebar is open.

For a Pakistani test person, the details include the name in Urdu. For a Japanese one, they include how the name is read.

## Commands

Open the command palette and type **Proxy Mail QA**.

| Command                                        | What it does                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------------ |
| Proxy Mail QA: Add a project’s API key         | Adds a project from its API key                                          |
| Proxy Mail QA: New address                     | Makes a test address with the sidebar’s choices and copies it            |
| Proxy Mail QA: Wait for a code                 | Waits for a code at an address you choose                                |
| Proxy Mail QA: Wait for a link                 | Waits for a link at an address you choose                                |
| Proxy Mail QA: Copy the latest code or link    | Copies the newest code or link at an address you choose                  |
| Proxy Mail QA: Insert a sign-up test           | Inserts a Playwright or Cypress test for sign-up, reset or magic link    |
| Proxy Mail QA: Insert a sign-up form           | Opens one of the project’s sign-up forms as React or HTML code           |
| Proxy Mail QA: Insert tests for a sign-up form | Opens Playwright or Cypress tests for one of the project’s sign-up forms |
| Proxy Mail QA: Open in Proxy Mail QA           | Opens the project in the app                                             |
| Proxy Mail QA: Remove a project                | Forgets the project and its key                                          |

## Tests

**Insert a sign-up test** asks which test you want and adds it where your cursor is. The same tests are snippets in TypeScript and JavaScript files: type `proxymail-` and pick one.

| Snippet                         | The test                                                                         |
| ------------------------------- | -------------------------------------------------------------------------------- |
| proxymail-signup-playwright     | Signs up with a new address and enters the code from the email                   |
| proxymail-reset-playwright      | Borrows a test account, resets its password from the email’s link, gives it back |
| proxymail-magic-link-playwright | Signs in with a magic link from the email                                        |
| proxymail-signup-cypress        | The sign-up test, with cy.proxymail                                              |
| proxymail-reset-cypress         | The password reset test, with cy.proxymail                                       |
| proxymail-magic-link-cypress    | The magic link test, with cy.proxymail                                           |

The tests use the [proxymail-qa](https://www.npmjs.com/package/proxymail-qa) npm package. Set it up with the [Playwright](https://proxymail.qa/docs/playwright) or [Cypress](https://proxymail.qa/docs/cypress) guide, and set `PROXYMAIL_QA_API_KEY` where the tests run.

## Sign-up forms

**Insert a sign-up form** asks which of the project’s [sign-up forms](https://proxymail.qa/docs/signup-forms) you want and in which kind of code: React with react-hook-form and zod, React with plain state, or one HTML page. It opens the code in a new editor, with notes at the top on what to check, and offers to copy the install command for any packages it needs.

**Insert tests for a sign-up form** asks for a form and a test runner, Playwright or Cypress, and opens tests that try values each field should take and values it should refuse. Notes at the top say what to check, and it offers to copy the install command.

Each field keeps its `data-testid`, so the form’s custom fields fill it. Your coding agent builds the forms with you, from a screenshot or what you describe.

## Privacy

The extension talks only to the Proxy Mail QA API, with your project’s key, and sends no usage data of its own. Codes, links and names from emails are shown as text, never as web content.

To remove a project and its key, run **Proxy Mail QA: Remove a project**.

[Previous](https://proxymail.qa/docs/cli.html): Command line

[Next](https://proxymail.qa/docs/ci.html): Running in CI
