A Go Git CLI.

This logo was created by gopherize.me.

ggc is a Git tool written in Go, offering both traditional CLI commands and an interactive interface with incremental search. You can either run subcommands like ggc add directly, or launch the interactive mode by simply typing ggc. Designed to be fast, user-friendly, and extensible.

• Traditional command-line interface (CLI): Run ggc [args] to execute specific operations directly.
• Interactive interface: Run ggc with no arguments to launch an incremental search UI for command selection.
• Simple commands for common Git operations (add, push, pull, branch, log, etc.)
• Composite commands that combine multiple Git operations
• Interactive UI for branch/file selection and message input
• Implemented using the Go standard library and:

• OS: macOS (Apple Silicon/Intel) - Verified
• Go version: 1.24 or later recommended
• Dependencies: Go standard library, golang.org/x/term, golang.org/x/sys, gopkg.in/yaml.v3
• Requirement: git command must be installed

Pre-compiled binaries are available for multiple platforms and architectures. This is the fastest way to get started with ggc.

Visit the Releases page to download the latest binary for your platform:

• macOS: darwin_amd64 (Intel), darwin_arm64 (Apple Silicon)
• Linux: linux_amd64, linux_arm64
• Windows: windows_amd64

The easiest way to install ggc is using the provided installation script:

# Download and run the installation script
curl -sSL https://raw.githubusercontent.com/bmf-san/ggc/main/install.sh | bash

Or download and run it manually:

# Download the script
curl -O https://raw.githubusercontent.com/bmf-san/ggc/main/install.sh

# Make it executable
chmod +x install.sh

# Run the script
./install.sh

The script will:

• Detect your operating system and architecture
• Download the appropriate binary for your system
• Install using git, manual go install fallback
• Verify the installation

git clone <repository URL>
make build

Place the ggc binary in a directory included in your PATH.

For development, you can use the Makefile to install required tools and dependencies:

# Install all dependencies and tools
make deps

# Run formatter
make fmt

# Run tests
make test

# Run linter
make lint

# Run tests with coverage
make cover

# Run tests and lint
make test-and-lint

# Build with go build
make build

# Build and run with version info
make run

The Makefile will automatically install required tools like golangci-lint using go install.

go install github.com/bmf-san/ggc@latest

• The ggc binary will be installed to $GOBIN (usually $HOME/go/bin).
• If $GOBIN is in your PATH, you can use ggc from anywhere.
• If not, add it to your PATH:

export PATH=$PATH:$(go env GOBIN)
# or
export PATH=$PATH:$HOME/go/bin

Just run:

• Type to filter commands (incremental search)
• Use ctrl+n/ctrl+p to move selection, Enter to execute
• If a command requires arguments (e.g. <file>, <name>, <url>), you will be prompted for input (always left-aligned)
• After command execution, results are displayed and you can press Enter to continue
• After viewing results, you return to the command selection screen for continuous use
• Use "quit" command or ctrl+c to exit interactive mode
• All UI and prompts are in English

main.go                  # Entry point
router/                  # Command routing logic
cmd/                     # Command entry handlers
git/                     # Git operation wrappers

Add the following to your ~/.bash_profile or ~/.bashrc:

if [ -f "$(go env GOPATH)/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.bash" ]; then
  . "$(go env GOPATH)"/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.bash
fi

Add the following to your ~/.zshrc:

if [ -f "$(go env GOPATH)/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.zsh" ]; then
  . "$(go env GOPATH)"/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.zsh
fi

Add the following to your ~/.config/fish/config.fish:

if test -f (go env GOPATH)/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.fish
    source (go env GOPATH)/pkg/mod/github.com/bmf-san/ggc@*/tools/completions/ggc.fish
end

This setup will automatically find the completion script regardless of the installed version.

Below are the Git commands that ggc wraps, along with links to their official documentation:

• git add - Add file contents to the index
• git clean - Remove untracked files from the working tree
• git restore - Restore files in the working tree

• git push - Update remote refs along with associated objects
• git pull - Fetch from and integrate with another repository or a local branch
• git fetch - Download objects and refs from another repository
• git remote - Manage set of tracked repositories

• git status - Show the working tree status
• git diff - Show changes between commits, commit and working tree, etc
• git stash - Stash the changes in a dirty working directory away

• git config - Get and set repository or global options
• git tag - Create, list, delete or verify a tag object signed with GPG
• git rebase - Reapply commits on top of another base tip

• lazygit - Simple terminal UI for Git commands
• tig - Text-mode interface for Git
• gitui - Blazing fast terminal-ui for Git
• magit - Git interface for Emacs

See CONTRIBUTING.md and CODE_OF_CONDUCT.md for details.

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

GitHub Sponsors – bmf-san

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

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