@constat-io/cli

One line, run on your own machine, that connects a repository to Constat:

npx @constat-io/cli connect owner/repo

The package is @constat-io/cli; the command it gives you is constat. Installed globally (npm i -g @constat-io/cli), you type constat connect owner/repo.

It reads the repository the way Constat's reporter reads it, writes what is missing — the workflow that publishes the check report, the runner, the pictures folder — on a branch, and opens a pull request in your name, with your own GitHub login.

  --constat <url>      where your Constat lives (default https://app.constat.io)
  --secret <NAME>      the repository secret your agents read their key from; may be repeated
  --runs-on <label>    run the attempts on a machine of your own with this runner label
  --goes-live <how>    "address" (the default) or "nothing"

Two things this tool will never do: touch your default branch, and ask for a secret's value. It prints the secret's name and where to put it, and that is the end of what it knows.

Where your login comes from

gh auth token first — whoever is already signed in on this machine, and the name the pull request will carry. GITHUB_TOKEN or GH_TOKEN in the environment wins over it, for a machine with no gh.

What you need

Node 22 or newer. Nothing else: the package carries everything it runs.