ggc

command module

v8.4.0 Latest Latest Go to latest Published: Apr 23, 2026 License: MIT Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/bmf-san/ggc

Links

Open Source Insights

README ¶

ggc

A Go Git CLI.

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

This logo was created by gopherize.me.

Demo

Click any GIF to view full size.

Interactive & Workflow mode	CLI workflow	Branch management

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 "<msg>"`, `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 <subcommand> 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 https://bmf-san.github.io/ggc/:

Why ggc? + feature highlights
Quick start
Command reference — auto-generated from the registry
Recipes — task-oriented walkthroughs
Interactive mode & workflows
Configuration, aliases, keybindings
Troubleshooting

Install

# 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. After installing, run ggc doctor to verify.

References

ggc documentation site - Full user guide, install notes, configuration reference, and troubleshooting
Git Documentation - Complete Git reference documentation
Git Tutorial - Official Git tutorial for beginners
Git User Manual - Comprehensive Git user guide

Contributing

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

Stargazers

Forkers

License

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

Documentation ¶

Overview ¶

Package main is the entry point for the ggc CLI tool.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd Package cmd provides command implementations for the ggc CLI tool.	Package cmd provides command implementations for the ggc CLI tool.
command Package command provides command metadata and registry functionality for ggc.	Package command provides command metadata and registry functionality for ggc.
internal
config Package config provides a base configuration schema for ggc.	Package config provides a base configuration schema for ggc.
git Package git provides a high-level interface to git commands.	Package git provides a high-level interface to git commands.
interactive Package interactive houses interactive UI types and helpers shared across the application.	Package interactive houses interactive UI types and helpers shared across the application.
keybindings Package keybindings provides a configurable keybinding system for interactive mode.	Package keybindings provides a configurable keybinding system for interactive mode.
prompt Package prompt provides user interaction utilities for CLI applications.	Package prompt provides user interaction utilities for CLI applications.
templates Package templates provides templates for help messages.	Package templates provides templates for help messages.
termio Package termio provides small terminal utilities shared across the interactive UI.	Package termio provides small terminal utilities shared across the interactive UI.
testutil Package testutil provides testing utilities for the ggc CLI tool.	Package testutil provides testing utilities for the ggc CLI tool.
ui Package ui provides shared terminal rendering utilities for the CLI.	Package ui provides shared terminal rendering utilities for the CLI.
tools
cmd/gencompletions command Command-line tool that generates shell completion scripts from the command registry.	Command-line tool that generates shell completion scripts from the command registry.
cmd/gendocs command Package main generates command documentation from the centralized registry.	Package main generates command documentation from the centralized registry.