Skip to content
repoverlay

Managing the Cache

GitHub repositories are cached locally to avoid re-downloading on every apply. repoverlay provides commands to manage this cache.

Viewing cached repositories

Section titled “Viewing cached repositories”
Terminal window
repoverlay cache list

Cache location

Section titled “Cache location”

To see where the cache is stored:

Terminal window
repoverlay cache path

The default location is ~/.cache/repoverlay/github/owner/repo/.

Clearing the cache

Section titled “Clearing the cache”

Remove all cached repositories:

Terminal window
repoverlay cache clear

Remove a specific cached repository:

Terminal window
repoverlay cache remove owner/repo

How caching works

Section titled “How caching works”
  • GitHub repos are shallow cloned to minimize disk usage
  • Caches are updated automatically during repoverlay update
  • Cache metadata tracks the commit hash and last update time
  • Changing --ref fetches the new ref into the existing cache