https://github.com/jv-k/delete-gh-workflow-runs
▶️ 👉🏻 🗑 Easily mass-delete GitHub Workflow runs
https://github.com/jv-k/delete-gh-workflow-runs
delete-workflow-runs github-api gitub-actions workflow-runs workflows
Last synced: 7 months ago
JSON representation
▶️ 👉🏻 🗑 Easily mass-delete GitHub Workflow runs
- Host: GitHub
- URL: https://github.com/jv-k/delete-gh-workflow-runs
- Owner: jv-k
- License: mit
- Created: 2022-02-01T22:20:10.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-31T13:51:38.000Z (10 months ago)
- Last Synced: 2025-04-14T04:47:43.044Z (7 months ago)
- Topics: delete-workflow-runs, github-api, gitub-actions, workflow-runs, workflows
- Language: Shell
- Homepage: https://npmjs.com/package/delete-workflow-runs
- Size: 1.85 MB
- Stars: 42
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ▶️ 👉🏻 🗑 Delete Workflow Runs
Easily mass-delete GitHub Workflow runs from your GitHub remote repository via the command line.
Conventiently select multiple entries to be deleted at once from a navigable list.
It uses the GitHub API, and requires gh (GitHub CLI) and jq (JSON processor).
## QuickStart
1. Install pre-requisites [GitHub CLI](https://github.com/cli/cli), [jq](https://github.com/stedolan/jq), and [fzf](https://github.com/junegunn/fzf) for example on `MacOS`:
```sh
$ brew install gh jq fzf
```
2. Install `delete-workflow-runs` globally:
```sh
$ npm i -g delete-workflow-runs
```
3. Authenticate to GitHub via `gh` client:
```sh
$ gh auth login
```
Follow the prompts in the terminal wizard to authenticate.
4. Navigate to the directory of the repository that you wish to delete workflow runs from, then run:
```sh
$ delete-workflow-runs
```
5. Use the `` and `` keys to navigate the list of workflow runs, and select the ones to be deleted with ``.
6. Press `` to delete the runs from your GitHub remote.
## Contributing
I'd love you to contribute to `@jv-k/delete-workflow-runs`, [pull requests](https://github.com/jv-k/delete-workflow-runs/issues/new/choose) are welcome for submitting issues and bugs!
## License
The scripts and documentation in this project are released under the [MIT license](https://github.com/jv-k/delete-workflow-runs/blob/master/LICENSE).