Delete GitHub Actions cache with ease.

GitHub Actions cache is limited to 10GB per repository. If you use a lot of cache storage, you may see the following warning message:

Approaching total cache storage limit (XX GB of 10 GB Used)

Least recently used caches will be automatically evicted to limit the total cache storage to 10 GB. Learn more about cache usage.

The documentation says:

GitHub will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited to 10 GB. Once a repository has reached its maximum cache storage, the cache eviction policy will create space by deleting the oldest caches in the repository.

Usage limits and eviction policy - GitHub Docs

To prevent reaching this limit, it’s essential to delete unused or unnecessary caches automatically.

name: Delete Action Cache
on:
  pull_request_target:
    types: [closed]
jobs:
  delete-cache:
    runs-on: ubuntu-latest
    steps:
      - uses: toshimaru/delete-action-cache@main

Use the workflow_dispatch event to trigger the action manually.

name: Delete Action Cache
on:
  workflow_dispatch:
jobs:
  delete-cache:
    runs-on: ubuntu-latest
    steps:
      - uses: toshimaru/delete-action-cache@main

• Select a branch from dropdown menu
• Click "Run workflow"
• The action deletes the branch caches

See also. Manually running a workflow - GitHub Docs

Delete caches periodically with the schedule event.

name: delete action cache
on:
  schedule:
    - cron: '0 3 * * *'
jobs:
  delete-cache:
    runs-on: ubuntu-latest
    steps:
      - uses: toshimaru/delete-action-cache@main
        branch: my-cache-branch

See action.yml

• pull_request
• pull_request_target
• workflow_dispatch
• schedule
• push