heimdalllisted

# Heimdall Heimdall turns a JSON plan into a structured test report. It is designed for agents, but it refuses to pretend that a blocked, skipped, or unexecuted case passed. ## Start safely ```bash heimdall doctor heimdall init -o heimdall.plan.json heimdall validate heimdall.plan.json heimdall run heimdall.plan.json ``` If the CLI is missing, install the public source release: ```bash npm install -g git+https://github.com/AntreasAntoniou/heimdall.git npx playwright install chromium ``` ## Choose the lane explicitly | Driver | Use it for | Important limit | | --- | --- | --- | | `cdp` | Parallel, self-driven browser and API checks | Fresh Playwright contexts are not a user's logged-in Chrome | | `container` | Destructive or untrusted systems needing isolation | Requires Docker; fidelity is Linux Chrome | | `extension` | Highest-fidelity checks in a real logged-in browser | Heimdall cannot self-drive it and reports the case `blocked` | Default to `cdp`. Use `container` when isolation matters more than desktop fidelity. Use `extension` only as an explicit handoff to a browser-capable human or agent. ## Author a real test Every case needs at least one oracle. A sequence of clicks without an assertion is not a test. ```json { "name": "smoke", "baseUrl": "http://localhost:3000", "defaultDriver": "cdp", "cases": [ { "id": "home-loads", "steps": [{ "action": "goto", "url": "/" }], "oracle": [ { "assert": "visible", "selector": "main"