reach clean

Clean cached Agent Registry payloads and evaluation artifacts.

---

Synopsis

reach clean [OPTIONS]

---

Behavior

1. Safe Default: By default, reach clean safely purges the .reach/cache/registry/ directory containing downloaded Google Cloud Agent Registry skill bundles and metadata cache files without deleting user-created benchmark queries or evaluation records.
2. Project Scoping: Passing --project <PROJECT_ID> restricts the cache purge to bundles from that specific Google Cloud project.
3. Dry-Run Preview: Passing --dry-run (-n) calculates and reports the list of cached directories and total reclaimed space without modifying disk files.
4. Full Artifact & Query Purge: Passing --all removes local evaluation run artifacts (.reach/eval.json, .reach/sweep.json, *.artifact.json, *.config.json) as well as local benchmark query files (.reach/queries.json, .reach/queries.jsonl, .reach/queries.csv).

---

Key Scenarios

Safe cache cleaningDry-run space calculationProject-scoped cache purgePurge all caches, runs, and queries

Purge cached Agent Registry payloads and manifests:

reach clean

Preview files and disk space that would be reclaimed:

reach clean --dry-run
reach clean -n

Purge cache for a specific Google Cloud project:

reach clean --project your-project-id

Delete registry cache along with local run artifacts (.reach/eval.json, .reach/sweep.json, *.artifact.json, *.config.json) and benchmark query sets (.reach/queries.json, .reach/queries.jsonl, .reach/queries.csv):

reach clean --all

---

Options

Option	Type	Default	Description
--project, -p	String	None	Purge cache only for the specified Google Cloud project ID.
--dry-run, -n	Flag	false	Display paths and space that would be reclaimed without deleting files.
--all	Flag	false	Purge all caches, run artifacts (.reach/eval.json, .reach/sweep.json, *.artifact.json, *.config.json), and query sets (.reach/queries.*).
--quiet, -q	Flag	false	Suppress summary output.