Skip to content

JSON output for agents

Use --json when another tool will consume the result.

Terminal window
suitener check ./backend --json

--json prints machine-readable JSON only:

  • no colors
  • no headings
  • no banners
  • no extra logs

Every run also writes:

suitener-results/latest.json

That stable path is the clean polling target for agents.

Minimal read pattern:

const result = await Bun.file("suitener-results/latest.json").json();
if (result.summary.failed > 0) {
throw new Error(result.tests.find((test) => test.status === "fail")?.error ?? "tests failed");
}