Study Scripts

Pro Study Scripts require a Pro license.

Creating a Study Script

MouseViz offers three ways to create study scripts:

Generate with AI

1. Open Study Scripts from the control bar or menu bar.
2. Select the Generate with AI tab.
3. Describe your study in plain English (e.g., "Test if users can find the checkout button and complete a purchase").
4. Click Generate Tasks — AI creates a structured script with timing estimates and success criteria.
5. Edit the generated tasks inline if needed.
6. Click Start Recording to begin, or Save as Template for later.

If the result isn't right, click Regenerate to get a new script from the same description.

MouseViz supports 5 AI providers: Apple Intelligence (free, on-device), Anthropic, OpenAI, Ollama (local), and OpenRouter. Configure your provider in Settings > AI.

Build Manually

1. Select the Build Manually tab.
2. Enter a study title and optional description.
3. Add tasks with titles, participant instructions, and estimated seconds.
4. Reorder tasks by dragging, remove with the minus button.
5. Save as template or start recording immediately.

Import from JSON

Click Import Script in the My Scripts tab to load a .json file conforming to the mouseviz://schemas/study-script/v1 schema.

Built-in Templates

MouseViz ships with 4 templates ready to use:

• E-Commerce Checkout Flow — 5 tasks covering product search to purchase
• SaaS Onboarding — 6 tasks for first-time user experience
• Navigation & Discoverability — 4 tasks testing information architecture
• Form Completion & Validation — 4 tasks for form usability

Managing Scripts

In the My Scripts tab:

• Edit — loads the script into the manual builder for editing
• Use — starts a recording session with the script
• Export — saves the script as a JSON file
• Delete — removes the script (with confirmation dialog)

During Recording

When a study script is loaded, the Task Conductor appears as a floating sidebar guiding you through each task.

Schema

Study scripts use a JSON schema (mouseviz://schemas/study-script/v1) that supports:

• Study metadata (title, description, tags, estimated duration)
• Ordered tasks with instructions and success criteria
• Criteria types: manual, urlMatch, timeUnder, custom
• Participant configuration (required fields)