gzh-cli-gitforge

Bulk-first Git operations CLI (gz-git) + Go library

gzh-cli-gitforge provides:

• gz-git (CLI): scan directories and run safe Git operations across many repositories in parallel.
• Go library: reusable packages under pkg/ for repository operations, bulk workflows, and forge sync.

---

CLI Highlights (gz-git)

• Bulk operations with --scan-depth and --parallel: status, fetch, pull, push, update, diff, commit, switch
• Bulk clone: clone --url ... / clone --file ... (+ --update)
• Repo sync:
  • sync forge (GitHub/GitLab/Gitea org/group/user)
  • sync run (YAML config)
• Maintenance: cleanup branch (dry-run by default)
• Monitoring: watch (default/compact/json/llm)
• Insights: history (stats/contributors/file/blame), info, merge detect
• Tag/stash helpers: tag, stash

---

Quick Start

Install

go install github.com/gizzahub/gzh-cli-gitforge/cmd/gz-git@latest
gz-git --version

Common Workflows

# Bulk status (current directory + 1 level)
gz-git status

# Fetch everything under ~/projects (2 levels deep)
gz-git fetch -d 2 ~/projects

# Update repos (pull --rebase), continuously
gz-git update --watch --interval 5m -d 2 ~/projects

# Bulk commit (preview → apply)
gz-git commit -d 2 ~/projects
gz-git commit --yes -d 2 ~/projects

# Switch branch across repos (create if missing)
gz-git switch feature/foo --create -d 2 ~/projects

# Bulk clone into ~/projects
gz-git clone ~/projects --url https://github.com/user/repo1.git --url https://github.com/user/repo2.git

# Sync all repos from a GitHub org
gz-git sync forge --provider github --org myorg --target ./repos --token $GITHUB_TOKEN

---

Requirements

• Git 2.30+
• Go 1.25.1+ (building from source / using as a library)

---

Documentation

• Docs index
• 5-minute quick start (Korean)
• Command reference (curated)
• Watch command guide
• Go library usage
• API reference: https://pkg.go.dev/github.com/gizzahub/gzh-cli-gitforge

---

License

MIT. See LICENSE.