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.
Install it
Section titled “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.
Add a project
Section titled “Add a project”Create an API key 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.
Make a test address
Section titled “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.
Wait for the code
Section titled “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
Section titled “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
Section titled “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 |
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 npm package. Set it up with the Playwright or Cypress guide, and set PROXYMAIL_QA_API_KEY where the tests run.
Sign-up forms
Section titled “Sign-up forms”Insert a sign-up form asks which of the project’s sign-up 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
Section titled “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.