Reticle Docs: verification for AI coding agents

reticle affected answers one question: given these changed files, which saved flows cover them? It is the foundation the gate and watch are built on, and it costs your agent nothing per turn because it runs in the environment.

npx reticle affected [--since <ref>] [file...]

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 nothing after it, reticle affected means the working tree against HEAD. It used to be a usage error, while the rule reticle init writes into the agent’s own instruction file told the agent to run it.

What it prints

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

{
  "t": "2026-08-14T19:38:46.407Z",
  "event": "reticle_affected",
  "changedFiles": ["docs/cli.mdx", "packages/server/src/tools/e2e-surface-drift.test.ts"],
  "affected": ["deploy-journey", "verify-route", "console-compose"],
  "unknownProvenance": ["deploy-journey", "verify-route", "console-compose"]
}

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 when you want a non-zero exit.

Worked example

npx reticle affected --since origin/main
npx reticle affected src/components/Login.tsx

Last modified on August 14, 2026

⌘I

Tools

Beyond the loop

CLI commands

Packages

Grammar

Long form

reticle affected

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