Tools: GitHub Actions Has a Cleanup Problem — So I Built a Tool

gh-prune 🧹 ## The Problem ## What is gh-prune? ## Key Features ## Prerequisites ## Installation Keep your GitHub Actions clean. No more ghost workflows. If you use GitHub Actions regularly, you’ve probably noticed something odd: Then comes the painful part: As a DevOps engineer, this felt like unnecessary friction. gh-prune solves this. gh-prune is a Python-based CLI tool built on top of the GitHub CLI. It is designed to inspect your repository, identify workflow runs, and help you bulk-delete old or unwanted history to properly clean up the Actions UI. Because gh-prune leverages the official GitHub CLI for authentication and API interaction, you must have it installed and authenticated. gh-prune is available on PyPI. You can install it via pip: Templates let you quickly answer FAQs or store snippets for re-use. Are you sure you want to ? It will become hidden in your post, but will still be visible via the comment's permalink. as well , this person and/or COMMAND_BLOCK: __ / | ______ $$ |____ ______ ______ __ __ _______ ______ / \ $$ \ ______ / \ / \ / | / |/ \ / \ /$$$$$$ |$$$$$$$ |/ |/$$$$$$ |/$$$$$$ |$$ | $$ |$$$$$$$ |/$$$$$$ | $$ | $$ |$$ | $$ |$$$$$$/ $$ | $$ |$$ | $$/ $$ | $$ |$$ | $$ |$$ $$ | $$ \__$$ |$$ | $$ | $$ |__$$ |$$ | $$ \__$$ |$$ | $$ |$$$$$$$$/ $$ $$ |$$ | $$ | $$ $$/ $$ | $$ $$/ $$ | $$ |$$ | $$$$$$$ |$$/ $$/ $$$$$$$/ $$/ $$$$$$/ $$/ $$/ $$$$$$$/ / \__$$ | $$ | $$ $$/ $$ | $$$$$$/ $$/ COMMAND_BLOCK: __ / | ______ $$ |____ ______ ______ __ __ _______ ______ / \ $$ \ ______ / \ / \ / | / |/ \ / \ /$$$$$$ |$$$$$$$ |/ |/$$$$$$ |/$$$$$$ |$$ | $$ |$$$$$$$ |/$$$$$$ | $$ | $$ |$$ | $$ |$$$$$$/ $$ | $$ |$$ | $$/ $$ | $$ |$$ | $$ |$$ $$ | $$ \__$$ |$$ | $$ | $$ |__$$ |$$ | $$ \__$$ |$$ | $$ |$$$$$$$$/ $$ $$ |$$ | $$ | $$ $$/ $$ | $$ $$/ $$ | $$ |$$ | $$$$$$$ |$$/ $$/ $$$$$$$/ $$/ $$$$$$/ $$/ $$/ $$$$$$$/ / \__$$ | $$ | $$ $$/ $$ | $$$$$$/ $$/ COMMAND_BLOCK: __ / | ______ $$ |____ ______ ______ __ __ _______ ______ / \ $$ \ ______ / \ / \ / | / |/ \ / \ /$$$$$$ |$$$$$$$ |/ |/$$$$$$ |/$$$$$$ |$$ | $$ |$$$$$$$ |/$$$$$$ | $$ | $$ |$$ | $$ |$$$$$$/ $$ | $$ |$$ | $$/ $$ | $$ |$$ | $$ |$$ $$ | $$ \__$$ |$$ | $$ | $$ |__$$ |$$ | $$ \__$$ |$$ | $$ |$$$$$$$$/ $$ $$ |$$ | $$ | $$ $$/ $$ | $$ $$/ $$ | $$ |$$ | $$$$$$$ |$$/ $$/ $$$$$$$/ $$/ $$$$$$/ $$/ $$/ $$$$$$$/ / \__$$ | $$ | $$ $$/ $$ | $$$$$$/ $$/ CODE_BLOCK: gh auth login CODE_BLOCK: gh auth login COMMAND_BLOCK: pip install gh-prune COMMAND_BLOCK: pip install gh-prune COMMAND_BLOCK: pip install gh-prune - You delete a workflow file (.github/workflows/old-flow.yml). - But the workflow still appears in the Actions tab. - Clicking through runs one by one. - Manually deleting history. - Realizing there’s no native bulk cleanup button. - 🔍 Inspect GitHub Actions workflows. - 📋 List workflow runs clearly. - 🗑️ Bulk Delete old or unwanted runs. - ✨ Clean the Actions UI of "deleted" workflows that persist in history. - Install GitHub CLI: Installation Guide - Authenticate: gh auth login