Home

GH-Workflow-Clean

gh-actions-cleanup is a macOS terminal CLI for shutting down and cleaning up GitHub Actions usage across repositories.

What It Does

• selects the GitHub host and authenticated account to use
• selects the target repository
• disables GitHub Actions workflows
• deletes workflow runs
• deletes Actions artifacts
• deletes Actions caches

Quick Links

• Installation and Usage
• Command Reference
• Safety and License
• FAQ

Quick Start

From the project folder:

chmod +x gh-actions-cleanup install-gh-actions-cleanup.sh
./install-gh-actions-cleanup.sh
gh-actions-cleanup

By default, the installer:

• installs the CLI command into a writable bin directory
• installs GH Workflow Clean.app into ~/Applications
• generates the app icon locally during install

Full cleanup:

gh-actions-cleanup --repo OWNER/REPO --all --yes

Safe preview first:

gh-actions-cleanup --repo OWNER/REPO --all --dry-run --yes

Target one leftover run series:

gh-actions-cleanup --repo OWNER/REPO --delete-runs --run-filter "Sync Google Analytics Data" --yes

Target one exact run:

gh-actions-cleanup --repo OWNER/REPO --run "https://github.com/OWNER/REPO/actions/runs/21023858697/workflow" --yes

App launch:

• open GH Workflow Clean.app from Finder, Spotlight, or Launchpad
• the app opens Terminal and runs the interactive CLI

Notes

• The CLI uses the selected active GitHub account on the selected host.
• If multiple accounts are authenticated on one host, it can switch using gh auth switch.
• The token in use needs repository and workflow access to delete Actions resources.
• You can target one exact workflow run by numeric ID or GitHub run URL.
• If the active token is invalid or the GitHub API core rate limit is exhausted, the CLI stops before cleanup and shows the next command to run.
• If local gh auth status looks stale but live GitHub API access still works, the CLI warns and continues.
• --dry-run is the safest way to confirm intended changes before deleting anything.
• The macOS app uses Terminal and may request automation permission the first time it launches.

Official Links

• Wayne Tech Lab LLC: WayneTechLab.com
• Public portfolio: Networks.CHAT

Creator Note

Built by Lucas / SatoshiUNO.