avr cache

Inspect and manage the Avrea build cache.

avr cache [OPTIONS] COMMAND [ARGS]...

Subcommands

avr cache delete

Delete cache entries by key name or all entries.

avr cache delete [OPTIONS]

Exactly one of --key or --all must be provided. When using --key, --type is required to scope the deletion.

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.

avr cache list [OPTIONS]

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

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.

avr cache usage [OPTIONS]

Examples:
    avr cache usage --repo rep-abc123
    avr cache usage --repo rep-abc123 --json '*'

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.