What problem does it solve?
Old CI container images accumulate in the GitHub Container Registry, cluttering the package list and making it hard to tell which versions are still load-bearing. Deleting them blindly is dangerous: untagged per-arch manifests look like garbage but are referenced by live multi-arch indexes, and removing them breaks tagged images.
Core Features & Use Cases
- Read-only audit: Generates a markdown review list of every positron OS/postgres image version older than a cutoff (default 90 days), automatically excluding tags referenced in the repo and children of retained multi-arch indexes.
- Fail-closed prune: Re-validates the reviewed list against live registry state before deleting, aborting on tag drift, newly in-use tags, unresolved manifests, or split multi-arch groups.
- Package cleanup: Optionally deletes packages emptied down to their last tagged version, which GHCR refuses to remove at the version level.
- Use Case: A maintainer wants to garbage-collect hundreds of stale
positron-rocky8 and positron-postgres image versions without breaking any CI workflow that still pins an old tag.
Quick Start
Ask the assistant to audit old GHCR CI images older than 90 days and produce a review list for pruning.