Skip to content
Lucas edited this page Mar 6, 2026 · 5 revisions

FAQ

Does this only work for one GitHub account?

No. It can prompt for the authenticated account to use, and it can switch accounts on the selected host with gh auth switch.

Does this only work for one repository?

No. The CLI is generic. You can point it at any repository you can access with the selected GitHub account.

What should I run first?

Start with:

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

That lets you confirm what would be touched before deleting anything.

What gets deleted?

Depending on the flags you choose, the CLI can affect:

  • workflow runs
  • artifacts
  • caches
  • enabled workflows

Can I use this for public and private repositories?

Yes, as long as the authenticated account and token have the required repository and workflow permissions.

Is this reversible?

Not generally. Deleting workflow runs, artifacts, and caches should be treated as destructive. Review the target carefully before running the command.

Clone this wiki locally