Give AI agents a fast way to test your apps from the inside.

Overview

vitexec is for checks that are too slow, visual, or stateful for normal agent browser control.

Use it to let an agent play through a scene, steer a camera, test game-like controls, inspect runtime state, and collect evidence without adding debug UI or temporary app code.

Install

npx skills add drawcall-ai/vitexec

Then ask your agent to use it:

Use $vitexec to move through the scene and inspect the camera position.

Problem

AI agents are slow when every action is a separate browser step.

Click, wait, inspect, press a key, wait again is expensive and often useless for interactive apps where movement, camera, physics, timing, and input all happen together.

The missing piece is a programmable control loop inside the running app.

Solution

vitexec lets the agent run a script inside the page instead of controlling the browser one action at a time.

The snippet can import real Vite modules, drive real input, wait for frames, branch on state changes, and run full multi-step flows before logging the result.

Each run gets an isolated Vite server, its own Playwright browser, streamed logs, and optional screenshots, videos, traces, profiles, HARs, or heap snapshots.

Better Than Alternatives

• Instead of adding test functions to the app: keep checks outside production code
• Instead of judging screenshots only: log exact runtime state
• Instead of one slow browser action at a time: run a state-aware script in-page
• Instead of hand-writing Playwright-style setup: give the agent one CLI tool
• Instead of sharing one dev server: run isolated checks in parallel
• Instead of fighting HMR during checks: use a Vite server with HMR disabled

Example

vitexec --gpu --path /scene '
  import { app } from "/src/app.ts";

  window.dispatchEvent(new KeyboardEvent("keydown", { code: "KeyW" }));
  await new Promise((resolve) => setTimeout(resolve, 1000));
  window.dispatchEvent(new KeyboardEvent("keyup", { code: "KeyW" }));

  const { object, camera } = app.getSnapshot();
  console.log("moved", JSON.stringify({ object, camera }));
'

logs:
[log] moved {"object":{"x":0,"y":0,"z":-4.2},"camera":{"yaw":0,"pitch":0}}

No debug panel. No test-only app code. No guessing from pixels alone.

Use It For

• Camera controls, pointer lock, drag interactions, and gamepad input
• Three.js scenes, physics simulations, canvas, WebGL, and WebXR
• Zustand, Redux, TanStack Query, or custom runtime stores
• Screenshots, videos, CPU profiles, HARs, traces, and heap snapshots
• Turning vague browser failures into readable logs

Commands

vitexec --gpu --path /scene 'console.log(location.pathname)'
vitexec --gpu --path /scene ./vitexec/check-scene.ts

Option	Use
--path /scene	Open a specific route
--config ./vite.config.ts	Use a specific Vite config
--gpu	Use generic GPU/WebGPU-friendly Chromium flags
--browser-ws-endpoint wss://...	Connect to a Playwright browser WebSocket endpoint
--browser-expose-network <loopback>	Expose local network routes to a remote browser
--screenshot ./page.png	Capture a full-page screenshot
--record ./run.webm	Record browser video
--cpu-profile ./cpu.cpuprofile	Capture a Chrome/V8 CPU profile
--network-trace ./network.har	Capture network requests as HAR
--performance-trace ./performance.trace.json	Capture a Chrome performance trace
--heap-snapshot ./heap.json	Capture a jq-friendly decoded heap snapshot
--timeout 30	Set the maximum wait time

Environment Variables

CLI flags take precedence over environment variables.

Environment variable	Equivalent option
VITEXEC_BROWSER_WS_ENDPOINT	--browser-ws-endpoint
VITEXEC_BROWSER_EXPOSE_NETWORK	--browser-expose-network
VITEXEC_CONFIG	--config
VITEXEC_PATH	--path
VITEXEC_GPU	--gpu
VITEXEC_TIMEOUT	--timeout
VITEXEC_SCREENSHOT	--screenshot
VITEXEC_RECORD	--record
VITEXEC_CPU_PROFILE	--cpu-profile
VITEXEC_NETWORK_TRACE	--network-trace
VITEXEC_PERFORMANCE_TRACE	--performance-trace
VITEXEC_HEAP_SNAPSHOT	--heap-snapshot

When --browser-ws-endpoint is set, vitexec only sends browser-generic GPU/WebGPU launch flags. Start the remote Playwright server with any host-specific GPU policy that matches its platform.