A Go Git CLI & CUI.
This logo was created by gopherize.me.
ggc is a Git tool written in Go, providing both a traditional command-line interface (CLI) and an interactive character user interface (CUI) with incremental search. It is designed to be fast, user-friendly, and extensible. (Go Git CLI & CUI)
- Traditional command-line interface (CLI): run
ggc <command> [args]for direct operations - Interactive character user interface (CUI): run
ggcwith 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
- All prompts and UI are in English
- All prompts and command inputs are always aligned to the left (no terminal right-shift issues)
- Implemented using only the Go standard library (+ golang.org/x/term)
- OS: macOS (Apple Silicon/Intel), Linux, WSL2 (Windows Subsystem for Linux)
- Go version: 1.21 or later recommended
- Dependencies: Go standard library + golang.org/x/term (no extra packages required)
- Requirement:
gitcommand must be installed
git clone <repository URL>
make buildPlace the ggc binary in a directory included in your PATH.
go install github.com/bmf-san/ggc@latest- The
ggcbinary will be installed to$GOBIN(usually$HOME/go/bin). - If
$GOBINis in yourPATH, you can useggcfrom anywhere. - If not, add it to your
PATH:
export PATH=$PATH:$(go env GOBIN)
# or
export PATH=$PATH:$HOME/go/binJust run:
ggc- 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) - All UI and prompts are in English
| ggc Command Example | Actual git Command | Description |
|---|---|---|
| ggc add | git add | Stage file(s) |
| ggc add -p | git add -p | Interactive hunk selection (patch mode) |
| ggc branch current | git rev-parse --abbrev-ref HEAD | Show current branch name |
| ggc branch checkout | git branch ... → git checkout | Interactive branch switch |
| ggc branch checkout-remote | git branch -r ... → git checkout -b ... --track ... | Create and checkout new local branch from remote |
| ggc branch delete | git branch ... → git branch -d | Interactive delete local branches |
| ggc branch delete-merged | git branch --merged ... → git branch -d | Interactive delete merged local branches |
| ggc push current | git push origin | Push current branch |
| ggc push force | git push --force origin | Force push current branch |
| ggc pull current | git pull origin | Pull current branch |
| ggc pull rebase | git pull --rebase origin | Pull with rebase |
| ggc log simple | git log --oneline | Show simple log |
| ggc log graph | git log --graph | Show log with graph |
| ggc commit allow-empty | git commit --allow-empty -m ... | Create empty commit |
| ggc commit tmp | git commit -m "tmp" | Temporary commit |
| ggc fetch --prune | git fetch --prune | Fetch with prune |
| ggc clean files | git clean -f | Clean files |
| ggc clean dirs | git clean -d | Clean directories |
| ggc reset clean | git reset --hard HEAD; git clean -fd | Reset and clean |
| ggc commit-push | Interactive add/commit/push | Select files, commit, and push interactively |
| ggc add-commit-push | git add . → git commit ... → git push | Add, commit, and push all at once |
| ggc pull-rebase-push | git pull → git rebase origin/main → git push | Pull, rebase, and push all at once |
| ggc stash-pull-pop | git stash → git pull → git stash pop | Stash, pull, and pop all at once |
| ggc reset-clean | git reset --hard HEAD → git clean -fd | Reset and clean all at once |
| ggc remote list | git remote -v | Show remotes |
| ggc remote add | git remote add | Add remote |
| ggc remote remove | git remote remove | Remove remote |
| ggc remote set-url | git remote set-url | Change remote URL |
main.go # Entry point
router/ # Command routing logic
cmd/ # Command entry handlers
git/ # Git operation wrappers
A bash completion script is available at tools/completions/ggc.bash.
# For bash
source /path/to/ggc/tools/completions/ggc.bash
# For zsh, you can also use source- Add the above to your
.bashrcor.zshrcto enable completion automatically on terminal startup. - Subcommand completion is supported.
See CONTRIBUTING.md for details.
This project is licensed under the MIT License - see the LICENSE.md file for details.