README
¶
gix - Mass-Delete GitHub Repositories
A fast, interactive CLI for bulk-managing your GitHub repositories. Pick repos from a searchable list, confirm once, and gix handles the rest.
Features
- Interactive picker — searchable, multi-select list of every repo you have admin access to
- Confirm screen — full list of what's about to be deleted, with an explicit y/n before anything happens
- Live progress view — see each repository's result as it's deleted
- Dry-run mode — preview exactly what would be deleted without touching anything
- Zero config auth — reuses your existing
ghCLI login, no separate token setup
Requirements
- GitHub CLI (
gh), installed and authenticated:gh auth login - Go 1.26+ (only if building from source)
gix checks that gh is installed and that your token has the delete_repo scope before doing anything else — if the scope is missing, it'll walk you through gh auth refresh automatically.
Install
go install github.com/alexkuchar/gix/cmd/gix@latest
If gix delete isn't found afterward, go install placed the binary in $(go env GOPATH)/bin, which may not be on your PATH yet. Add it with:
export PATH="$PATH:$(go env GOPATH)/bin"
(put that line in your ~/.zshrc or ~/.bashrc to make it permanent).
Homebrew and a pkg.go.dev listing are on the way.
Usage
gix delete
Preview without deleting anything:
gix delete --dry-run
Picker controls
| Key | Action |
|---|---|
space |
toggle selection |
a |
select all |
n |
select none |
/ |
filter/search |
enter |
confirm selection |
q / ctrl+c |
quit |
After confirming your selection, gix shows every repo you're about to delete and asks for a final y/n before it does anything irreversible.
Roadmap
- Mass-delete repositories
- Mass-archive repositories
- Mass-transfer repositories (pending GitHub REST API support)
- Mass privacy toggles (public/private)
Directories