create-healix

Scaffold a Healix test-automation project in one command — a ready-to-run WebdriverIO setup wired for AI-assisted authoring and self-healing, standalone test suites.

npx create-healix my-app
cd my-app

What you get

• WebdriverIO + Healix service preconfigured (wdio.web.conf.ts).
• .mcp.json registering the healix-mcp server, so an AI agent (Claude Code, Cursor, Windsurf, …) can drive the live browser, observe the real DOM, and author specs/page objects for you.
• Two-file page-object model + an example spec/POM to copy.
• Allure reporting and a reports/screenshots/ directory wired out of the box.
• CLAUDE.md + a SessionStart hook so the agent always loads the framework guide.

Options

| Flag | Effect | |------|--------| | --yes, -y | Accept all defaults | | --platforms=web,android,ios | Target platforms (default web) | | --app-url=<url> | Default app URL for the example spec | | --mcp=cursor\|claude\|windsurf | Which MCP client to configure | | --skip-install | Don't run npm install |

Run it

npm run session:web   # opens a live browser + the Healix API for the agent to drive
npm test              # runs the suite standalone — no AI, no MCP

The deliverable is a normal WDIO suite: it runs in CI with npx wdio run and no AI in the loop.

See wdio-healix-service (the framework) and healix-mcp (the agent server).