GitHub Action Artifacts are removed after 90 days. This cannot be configured either globally or per project. There's also a limit on free artifact space after which it becomes a payed resource. There's no configurable storage limit per project either, so some projects might use up all quota and not leave room for others.

We created this Action to solve these problems. It can

• remove artifacts that are older than some custom timeframe
• keep release (tagged) artifacts

.github/workflows/remove-old-artifacts.yml

name: Remove old artifacts

on:
  schedule:
    # Every day at 1am
    - cron: '0 1 * * *'

jobs:
  remove-old-artifacts:
    runs-on: ubuntu-latest
    timeout-minutes: 10

    steps:
    - name: Remove old artifacts
      uses: c-hive/gha-remove-artifacts@master
      with:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        age: '1 month'
        skip-tags: true

The action makes use of the @octokit/plugin-throttling to throttle the requests and automatically retry them in case of exceeding the limitations. It's strongly advised explicitly setting the timeout-minutes option to prevent running the action for way too long.

This project follows C-Hive guides for code style, way of working and other development concerns.

The project is available as open source under the terms of the MIT License.