Home

GH-Workflow-Clean

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

Current release: 0.0.1

What It Does

• checks GitHub CLI authentication status first
• lets you choose the GitHub host and authenticated account to use
• lets you choose the target repository or paste a full GitHub repo URL
• disables GitHub Actions workflows
• deletes workflow runs
• deletes Actions artifacts
• deletes Actions caches
• remembers the last host, account, and repo you used without storing any tokens or secrets

Quick Links

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

Quick Start

From any Mac:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/WayneTechLab/GH-Workflow-Clean/main/install.sh)"
gh auth login -h github.com
gh-actions-cleanup

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 starts the W.T.L. guided menu

Notes

• Users must authenticate first with gh auth login -h <host>.
• 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 and restore the prior active account when the session ends.
• The tool does not embed, print, or save GitHub tokens.
• 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.
• The tool stores only the last host, account, and repo in ~/Library/Application Support/GH Workflow Clean/last-session.env.
• --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.