🧹 GitClean CLI

A simple CLI tool written in Go to identify and optionally delete stale local Git branches that no longer exist on the remote. Keeps your local Git repo clean and manageable.

---

✨ Features

• 🔍 Detects stale local branches by comparing against a remote
• 🗑️ Optionally delete stale branches via --delete
• 🌐 Supports custom remotes (default: origin)
• ⚙️ Pure Go with minimal code and no dependencies
• 🔒 Never deletes main or master branches

---

📦 Installation

Option 1: Go Install

go install github.com/hadzicni/gitclean-cli/cmd/gitclean@latest

Make sure $GOPATH/bin is in your $PATH.

Option 2: Manual Build (Windows, Linux, macOS)

🪟 Windows (PowerShell oder CMD)

git clone https://github.com/hadzicni/gitclean.git
cd gitclean/cmd/gitclean
go build -o gitclean.exe

🐧 Linux / 🍏 macOS

git clone https://github.com/hadzicni/gitclean.git
cd gitclean/cmd/gitclean
go build -o gitclean

---

🚀 Usage

gitclean [flags]

Available Flags

Flag	Description
--delete, -d	Delete all stale local branches
--remote, -r	Specify remote to compare against (default: origin)

---

🔧 Examples

List stale branches:

gitclean

List using a custom remote:

gitclean -r upstream

Delete all stale branches:

gitclean -d

---

👨‍💻 Author

Made by Nikola Hadzic
GitHub: @hadzicni

---

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.