An open API service indexing awesome lists of open source software.

https://github.com/bmf-san/ggc

A modern Git CLI tool with both traditional command-line and interactive incremental-search UI.
https://github.com/bmf-san/ggc

cli developer-tools git go golang sdg-17 sdg-9

Last synced: 15 days ago
JSON representation

A modern Git CLI tool with both traditional command-line and interactive incremental-search UI.

Awesome Lists containing this project

README

          

# ggc
[![GitHub release](https://img.shields.io/github/release/bmf-san/ggc.svg)](https://github.com/bmf-san/ggc/releases)
[![Go Report Card](https://goreportcard.com/badge/github.com/bmf-san/ggc)](https://goreportcard.com/report/github.com/bmf-san/ggc)
[![codecov](https://codecov.io/gh/bmf-san/ggc/branch/main/graph/badge.svg)](https://codecov.io/gh/bmf-san/ggc)
[![GitHub license](https://img.shields.io/github/license/bmf-san/ggc)](https://github.com/bmf-san/ggc/blob/main/LICENSE)
[![Go Reference](https://pkg.go.dev/badge/github.com/bmf-san/ggc.svg)](https://pkg.go.dev/github.com/bmf-san/ggc)
[![Sourcegraph](https://sourcegraph.com/github.com/bmf-san/ggc/-/badge.svg)](https://sourcegraph.com/github.com/bmf-san/ggc?badge)
[![CI](https://github.com/bmf-san/ggc/actions/workflows/ci.yml/badge.svg)](https://github.com/bmf-san/ggc/actions/workflows/ci.yml)
[![CodeQL](https://github.com/bmf-san/ggc/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/bmf-san/ggc/actions/workflows/github-code-scanning/codeql)
[![Dependabot Updates](https://github.com/bmf-san/ggc/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/bmf-san/ggc/actions/workflows/dependabot/dependabot-updates)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/bmf-san/ggc/badge)](https://scorecard.dev/viewer/?uri=github.com/bmf-san/ggc)
[![Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go)

A Go Git CLI.

📖 **Full documentation:** https://bmf-san.github.io/ggc/

ggc

This logo was created by [gopherize.me](https://gopherize.me/gopher/d654ddf2b81c2b4123684f93071af0cf559eb0b5).

## Demo

Click any GIF to view full size.

| Interactive & Workflow mode | CLI workflow | Branch management |
| --- | --- | --- |
| [Interactive overview demo](docs/demos/generated/interactive-overview.gif) | [CLI workflow demo](docs/demos/generated/cli-workflow.gif) | [Branch management demo](docs/demos/generated/branch-management.gif) |
| Fuzzy-search every `ggc` command, then press Tab to queue them into a workflow and Ctrl+T to run the pipeline. | Traditional one-shot commands: `ggc status`, `ggc add`, `ggc commit ""`, `ggc log simple`. | Create and switch branches with plain verbs; interactive pickers appear when arguments are omitted. |

## Overview

ggc is a Git tool written in Go, offering both a traditional CLI and an interactive TUI with incremental search and multi-command workflows. Run `ggc ` directly, or type `ggc` on its own to open the fuzzy picker.

Supported: macOS (amd64 / arm64 / universal), Linux (amd64 / arm64), Windows (amd64). Requires Git and Go 1.25+ to build.

Full documentation lives at ****:

- [Why ggc? + feature highlights](https://bmf-san.github.io/ggc/#why-ggc)
- [Quick start](https://bmf-san.github.io/ggc/guide/quickstart/)
- [Command reference](https://bmf-san.github.io/ggc/guide/commands/) — auto-generated from the registry
- [Recipes](https://bmf-san.github.io/ggc/guide/recipes/) — task-oriented walkthroughs
- [Interactive mode & workflows](https://bmf-san.github.io/ggc/guide/interactive/)
- [Configuration, aliases, keybindings](https://bmf-san.github.io/ggc/guide/config/)
- [Troubleshooting](https://bmf-san.github.io/ggc/guide/troubleshooting/)

## Install

```bash
# quick install (macOS / Linux)
curl -sSL https://raw.githubusercontent.com/bmf-san/ggc/main/install.sh | bash

# or Homebrew
brew install ggc

# or Go
go install github.com/bmf-san/ggc/v8@latest
```

Windows binaries, pre-built archives, and source builds are covered in the [installation guide](https://bmf-san.github.io/ggc/guide/install/). After installing, run `ggc doctor` to verify.

## References

- [ggc documentation site](https://bmf-san.github.io/ggc/) - Full user guide, install notes, configuration reference, and troubleshooting
- [Git Documentation](https://git-scm.com/docs) - Complete Git reference documentation
- [Git Tutorial](https://git-scm.com/docs/gittutorial) - Official Git tutorial for beginners
- [Git User Manual](https://git-scm.com/docs/user-manual) - Comprehensive Git user guide

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details.

## Sponsor

If you’d like to support my work, please consider sponsoring me!

[GitHub Sponsors – bmf-san](https://github.com/sponsors/bmf-san)

Or simply giving ⭐ on GitHub is greatly appreciated—it keeps me motivated to maintain and improve the project! :D

## Stargazers
[![Stargazers repo roster for @bmf-san/ggc](https://reporoster.com/stars/bmf-san/ggc)](https://github.com/bmf-san/ggc/stargazers)

## Forkers
[![Forkers repo roster for @bmf-san/ggc](https://reporoster.com/forks/bmf-san/ggc)](https://github.com/bmf-san/ggc/network/members)

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.