GitHub Action Cleaner

Effortlessly clean up workflow runs in your GitHub repository with ready-to-use GitHub Actions.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License
6. Contact
7. Acknowledgments

About The Project

GitHub Action Cleaner helps you automatically delete old or failed workflow runs from your repository using simple, ready-to-use GitHub Actions workflows.
No manual script setup or local execution is required—just copy the workflow YAML file to your repo and run it from the Actions tab.

Features:

• Delete all workflow runs except the current one.
• Delete up to 100 most recent failed workflow runs.
• No local setup or dependencies required.
• Secure: uses GitHub Actions tokens.

(back to top)

Built With

• Python
• GitHub Actions

(back to top)

Getting Started

Prerequisites

• A GitHub repository with Actions enabled.
• Repository admin or write access.

Installation

1. Download one of the workflow files from this repository:
   • cleanup-all-runs.yml: Deletes all workflow runs except the current one.
   • cleanup-failed-runs.yml: Deletes up to 100 most recent failed workflow runs.
2. Copy the file into your own repository at .github/workflows/.
3. Commit and push the changes.

(back to top)

Usage

1. Go to your repository's Actions tab.
2. Select the workflow you added (e.g., "Cleanup All Workflow Runs" or "Cleanup Failed Workflow Runs").
3. Click Run workflow to trigger the cleanup.

The workflow will automatically download and execute the latest cleanup script for you.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Top contributors:

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Project Link: https://github.com/LoveDoLove/Github-Action-Cleaner

(back to top)

Acknowledgments

• Best-README-Template
• GitHub Actions Documentation
• Requests Library

(back to top)