# avr cache Inspect and manage the Avrea build cache. ```sh avr cache [OPTIONS] COMMAND [ARGS]... ``` ## Subcommands ### `avr cache delete` Delete cache entries by key name or all entries. ```sh avr cache delete [OPTIONS] ``` Exactly one of --key or --all must be provided. When using --key, --type is required to scope the deletion. ```sh Examples: avr cache delete --repo rep-abc123 --type gha --key "node_modules" --ref refs/heads/main --yes avr cache delete --repo rep-abc123 --all --yes ``` **Options** - --repo <TEXT> — Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted. - --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org). - --type <TEXT> — Cache type (required with --key, e.g. gha, bazel, sccache). - --key <TEXT> — Delete entries matching this cache key name. - --ref <TEXT> — Ref to narrow deletion scope (used by gha). - --all — Delete ALL cache entries for the repository. - --yes, -y — Skip confirmation prompt. ### `avr cache list` List cache entries for a repository. ```sh avr cache list [OPTIONS] ``` ```sh Examples: avr cache list --repo rep-abc123 avr cache list --repo rep-abc123 --type gha --limit 50 avr cache list --repo rep-abc123 --key "node_modules" --ref refs/heads/main avr cache list --repo rep-abc123 --json key,size_bytes,created_at ``` ```sh JSON FIELDS cache_type, created_at, hit_count, key, last_accessed_at, ref, size_bytes, version ``` **Options** - --repo <TEXT> — Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted. - --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org). - --type <TEXT> — Filter by cache type (e.g. gha, bazel, turbo, rclone). - --key <TEXT> — Filter by key prefix. - --ref <TEXT> — Filter by exact ref match. - -L, --limit <INTEGER RANGE> — Max entries to return. _(default: `100`)_ - --offset <INTEGER RANGE> — Number of entries to skip. _(default: `0`)_ - --order <CHOICE> — Sort order. _(choices: `created_at.desc`, `created_at.asc` · default: `created_at.desc`)_ - --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields. - -q, --jq <TEXT> — Filter --json output through a jq expression. - --web — Open in browser. ### `avr cache usage` Show cache usage summary for a repository. ```sh avr cache usage [OPTIONS] ``` ```sh Examples: avr cache usage --repo rep-abc123 avr cache usage --repo rep-abc123 --json '*' ``` ```sh JSON FIELDS by_type, over_quota, quota_bytes, total_size_bytes ``` **Options** - --repo <TEXT> — Repository (org/repo or rep-xxx). Auto-detected from git remote if omitted. - --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org). - --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields. - -q, --jq <TEXT> — Filter --json output through a jq expression.