Overview
The Preview Editor combines test authoring with live execution feedback, allowing you to validate test steps as you write them. The Spur agent executes your instructions in a live browser environment, providing immediate visibility into how your tests perform.Getting started
1
Open Preview Editor
Navigate to the test you want to edit and click Preview Editor.

2
Configure viewport
Select the viewport for your test session - either Desktop or Mobile. This determines the screen dimensions the Spur agent will use during test execution.You can reference the Viewports for detailed information on viewport configurations.

3
Enter the editing environment
The Preview Editor launches an interactive test authoring environment with multiple capabilities accessible through different tabs and panels.

Navigating the editing environment
This section consists of several key components that let you edit steps, inspect runs, and debug failures.
1. Test steps
1. Test steps
Write and execute test steps in the left panel. The editor supports adding, editing, and running individual steps or complete test sequences.

2. Dependencies
2. Dependencies
Configure test dependencies and tear down tests to control test execution order. The Dependencies panel allows you to establish relationships between tests.

3. Details
3. Details
Configure test metadata and expected outcomes in the Details panel. This section allows you to add descriptive information about your test.

4. Spursor Sandbox
4. Spursor Sandbox
Watch the Spur agent execute your test steps in real-time within a live browser environment. The sandbox displays exactly what the agent sees and does during test execution.

5. Preview mode
5. Preview mode
Review the agent’s planned actions before execution.

6. Agent logs
6. Agent logs
View the agent’s thought process when evaluating and executing test steps. Agent logs provide insight into how the agent interprets your instructions and decides on actions.

7. Console logs
7. Console logs
View real-time console logs generated when running tests, including warnings, errors, and debug messages from the browser.

8. Network logs
8. Network logs
View real-time network activity during test execution, including API requests, response status codes, methods, and domains.

9. Environment
9. Environment
View extracted or generated values saved in the testing environment. These values can be accessed and used in subsequent test steps.

10. Scroll estimations
10. Scroll estimations
Access page and window dimensions to aid test step creation. View current scroll position, page dimensions, and window size. You can also scroll within the Spursor Sandbox and access the page position directly.

Copy and paste in the test browser
Copy text inside the remote test creation browser to put it on your computer’s clipboard. To paste text into the remote browser, focus it and pressCtrl+V, or Cmd+V on macOS.
Spur reads your local clipboard only when you use the paste shortcut. It does not read it when you hover over or click the remote browser. Your browser may ask for clipboard permission.
On macOS, Spur translates supported Cmd shortcuts to the remote browser’s Ctrl shortcuts. Shortcuts reserved by your local browser, such as opening or closing a tab, stay local. Clipboard transfer supports plain text.
Key benefits
Resolving Test Step Issues
Preview Editor allows you to walk through the agent’s exact execution process, identifying and resolving issues with test steps in real-time.
Transparency in AI Decision Making
Provides complete visibility into how the agent interprets and executes your instructions, helping you understand its decision-making process.
Prompting Practice & Learning
By observing how the AI responds to different instructions in real-time, you can improve your prompting skills and learn the most effective ways to communicate with the agent.
Quality Assurance
Preview Mode ensures that each step executes exactly as intended, reducing errors and improving test reliability. You maintain full control over the agent’s actions before execution.
