Introduction

Hover is a Vite/Astro/Nuxt/Next/Webpack plugin that injects a floating chat widget into your dev server page. You type — or speak — a natural-language instruction like "test the login flow". An agent drives your actual dev Chrome over CDP, narrates each step, and crystallizes the verified session into a standard Playwright spec under __vibe_tests__/.

The differentiator vs. Stagehand / Midscene / Playwright codegen is the AI exploration → deterministic script workflow: AI authors the test, but the saved artifact is plain @playwright/test code that runs in CI without an agent in the loop.

What's inside this section

• Quick start — Install in your existing project. 60 seconds.
• Install — Pick your bundler. npx @hover-dev/cli setup auto-detects.
• Your first session — A guided walkthrough of every widget control.
• Pick an agent — six agents wired today: Claude (hard sandbox) plus Codex, cursor-agent, aider, gemini-cli, and qwen-code (soft sandbox). One-file registry to add more.

Hover has optional plugins for specialised workflows. The first is Security testing — installs alongside the base plugin and adds a mode that captures HTTPS traffic + lets the agent probe for authz / authn / parameter-tampering issues, crystallising findings into Playwright regression specs.

Building Hover itself? See Development for the monorepo workflow.

At a glance

• No API key required. Hover spawns the coding-agent CLI you already have on PATH (claude, codex, …) and reuses the subscription you already pay for — or set a model API key if you'd rather.
• No production overhead. Plugins are no-op in production builds (apply: 'serve').
• Local-first. The Node service binds to 127.0.0.1 only. Cookies and localStorage never transit it.
• One artefact, multiple formats. Save the same session as a Playwright spec or a Jira / Xray-compatible test case CSV — and with the optional @hover-dev/security plugin loaded, a Security spec entry also appears in the Save dropdown.