@healflow/cli

Command-line interface for HealFlow — initialize projects, validate setup, view reports, and sync to cloud.

Overview

Provides the healflow binary for the Install → Run Tests → Review Fixes workflow. Works standalone in any Playwright project after npm install.

Published to npm.

Installation

npm install @healflow/cli @healflow/playwright @playwright/test

Commands

healflow init

Scaffold HealFlow in the current directory:

npx healflow init

Creates:

• healflow.yml — configuration
• healflow.fixtures.ts — auto-healing test fixtures
• Patches or creates playwright.config.ts with @healflow/playwright

Cloud registration:

npx healflow init --cloud \
  --url https://api.healflow.example \
  --org my-org \
  --repo my-repo \
  --token hf_...

healflow doctor

Validate config, Playwright setup, and optional backend connectivity:

npx healflow doctor

healflow report

Open the local HTML report from the last test run:

npx healflow report

Requires .healflow/report.html (created by npx playwright test).

healflow ingest

Upload Playwright JSON report failures to the HealFlow API:

npx healflow ingest test-results/results.json

Requires backend.url, organizationId, and repositoryId in healflow.yml.

Typical workflow

npx healflow init
npx playwright test
npx healflow report

Configuration

Reads healflow.yml from the project root. See @healflow/shared for the full config schema.

Development

From the monorepo root:

pnpm healflow doctor
pnpm --filter @healflow/cli build

Related packages

• @healflow/playwright — runtime plugin wired by init
• @healflow/ingestion — report parsing for ingest

License

MIT