@nimrobo/wand-web

Framework-native dev inspector for web apps. Wand adds a small overlay to your local dev server that lets you click elements, capture context (HTML, screenshots, network), and hand it off to an AI coding agent — without leaving the page. The hand-off is powered by Superconnector.

Currently supports Next.js, Astro, and Vite projects.

Requirements

• Node.js >= 20
• A Next.js, Astro, or Vite project

Install

npm install -D @nimrobo/wand-web
npx wand init
npm run dev

wand init detects the supported framework, installs its native bootstrap, and rewrites the dev script so the Wand local service starts before the original dev command.

After initialization, you can also run a wrapped command directly instead of the rewritten script:

npx wand npm run dev

Artifacts

The overlay writes captures, queued requests, and screenshots under .wand/ in the project root. These files are local development artifacts and are ignored by git by default.

Troubleshooting

See TROUBLESHOOTING.md for common issues with the Astro and Vite adapters.

Verification

Astro and Vite support include opt-in fixture checks that stay out of the default test suite:

npm run test:astro-dev
npm run test:astro-production
npm run test:vite-dev
npm run test:vite-production

License

Apache-2.0