@cairntools/cli

The cairn command — graph-driven testing for your app. Author flows as versioned YAML graphs of user behavior, validate them against your code, and run or compile them.

Install

npm i -g @cairntools/cli
cairn --version

Requires Node.js ≥ 20. cairn run uses Playwright; run npx playwright install once to fetch browsers.

Quick start

cairn login            # browser-based sign-in
cairn init             # bind this repo to a project (writes .graphs/.config.yaml)
cairn record <flow>    # voice walkthrough → flow YAML
cairn validate         # schema-check every .graphs/*.yaml
cairn run <flow>       # execute a flow against an environment

Commands

init · login · logout · whoami · validate · record · run · compile · scan · accept · edit · diff

Run cairn --help or cairn <command> --help for the full reference.

Links

• Repository: https://github.com/cairntools/cairn
• The full command reference is generated from the CLI and published on the Cairn docs site.