Command Reference

Command Reference

Primary Flags

• --host HOST Selects the GitHub host, for example github.com.
• --account USER Selects the authenticated GitHub account to use on the selected host.
• --repo OWNER/REPO Targets a repository by owner and repository name.
• --repo HOST/OWNER/REPO Targets a repository with an explicit host.
• --disable-workflows Disables all workflows in the target repository.
• --delete-runs Deletes workflow runs in the target repository.
• --run-filter TEXT Deletes only workflow runs whose name, title, or path contains TEXT.
• --delete-artifacts Deletes Actions artifacts in the target repository.
• --delete-caches Deletes Actions caches in the target repository.
• --all Runs the full cleanup flow.
• --yes Skips the final confirmation prompt.
• --dry-run Shows intended actions without deleting anything.
• --no-color Disables colored terminal output.
• --version Prints the current CLI version.

Common Examples

Interactive mode:

gh-actions-cleanup

Full cleanup:

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

Target a specific host and account:

gh-actions-cleanup --host github.com --account USERNAME --repo OWNER/REPO --all --yes

Dry run:

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

Runs only:

gh-actions-cleanup --repo OWNER/REPO --delete-runs --yes

Runs only for one workflow series:

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

Artifacts only:

gh-actions-cleanup --repo OWNER/REPO --delete-artifacts --yes

Caches only:

gh-actions-cleanup --repo OWNER/REPO --delete-caches --yes