Installation and Usage

Installation and Usage

Requirements

• macOS
• GitHub CLI (gh)
• a GitHub account authenticated with gh auth login
• Xcode or Command Line Tools if you want the native GUI app built locally from source

Public Install

From any Mac:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/WayneTechLab/GH-Workflow-Clean/main/install.sh)"

Then:

gh auth login -h github.com
gh-actions-cleanup

Or open the native app:

open "/Applications/GH Workflow Clean.app"

Local Install From Source

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

Installer behavior:

• removes older CLI installs before reinstalling
• removes older app bundles before reinstalling
• installs the CLI into a writable macOS bin directory
• installs the app into /Applications when writable, otherwise ~/Applications
• builds the native Finder/Dock icon from the shipped AppIcon.appiconset
• bundles the current version and Terms of Service into the app
• bundles help files, security notes, brand docs, and project info into the app
• uses the existing gh keychain session instead of storing tokens
• redacts common token and key patterns from the native app log panel
• keeps quick auth actions in the lower status bar
• moves full GitHub host/account controls to a dedicated Settings page

CLI Use

Interactive:

gh-actions-cleanup

Full cleanup:

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

Dry run:

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

Native App Use

The native app includes:

• a responsive SwiftUI single-shell dashboard
• ultrawide, desktop, compact, and narrow layouts
• repository list loading with search, checkmarks, and select-all
• a cleaner Control Center without a separate auth widget
• a dedicated Settings page for GitHub host, account, login, logout, and session controls
• a lower status bar with Refresh, Login or Re-Login, Logout, and direct Settings access
• live output console
• safety arm switch before destructive actions run
• an every-launch warning and Terms of Service acceptance screen
• built-in help actions for terms, security notes, brand docs, and project info