Reticle Docs: verification for AI coding agents

reticle gate --list answers one question: given these changed files, which saved flows cover them? The gate checks the same set. --list only names it and checks nothing. It costs your agent nothing per turn because it runs in the environment.

npx @reticlehq/server gate --list [--since <ref>] [file...]

reticle affected is the old name. It still works for one release and prints one line naming gate --list.

Arguments and flags

Argument	Type	Default	What it does
`file...`	strings, positional	none	Explicit changed files
`--since <ref>`	string	`HEAD` when no files are given	Also include files git reports as changed since this ref

With no files, reticle gate --list compares the working tree with HEAD.

What it prints

One reticle_affected line. Real capture from this repository, with the file and flow lists trimmed for length:

{
  "t": "2026-08-15T18:42:58.072Z",
  "event": "reticle_affected",
  "changedFiles": ["docs/cli.mdx"],
  "affected": ["WEB-flow", "console-compose", "deploy-journey", "verify-route"],
  "unknownProvenance": ["WEB-flow", "console-compose", "deploy-journey", "verify-route"]
}

The real run named 47 flows in each list. The CLI prints this as a single line of JSON; it is pretty-printed here to be readable.

Field	Meaning
`changedFiles`	The resolved file set: your positional arguments plus whatever `--since` added
`affected`	Saved flows that cover at least one of those files
`unknownProvenance`	Flows with no recorded source mapping. They are listed as affected because the safe assumption is that they might be

Exit codes

Always 0. A load error is logged as reticle_affected_failed, not thrown. Use reticle gate without --list when you want a non-zero exit.

Worked example

npx @reticlehq/server gate --list --since origin/main
npx @reticlehq/server gate --list src/components/Login.tsx

Last modified on November 4, 2026

Tools

Beyond the loop

CLI commands

Packages

Grammar

Long form

reticle gate --list

Arguments and flags

What it prints

Exit codes

Worked example

​Arguments and flags

​What it prints

​Exit codes

​Worked example

Arguments and flags

What it prints

Exit codes

Worked example