ggc is a modern Git command-line interface (CLI) tool designed to streamline and enhance version control workflows. Built using Go, ggc offers a blend of traditional command-line commands and an interactive user interface with incremental search capabilities, catering to both seasoned developers and newcomers alike.

Key Features

• Traditional CLI Commands: Execute Git operations directly using commands like ggc add <file>, allowing for efficient and familiar usage.
• Interactive Mode: Simply enter ggc to enter an interactive interface where commands can be selected via a search interface, making it easy to find and execute commands.
• Simple Commands for Common Tasks: Perform essential Git operations such as add, push, pull, branch, and log with straightforward commands.
• Composite Commands: Combine multiple Git operations into single commands for improved efficiency.
• Interactive UI: Select branches or files and input commit messages seamlessly through the interactive UI, enhancing user experience and reducing command line errors.

Environments Supported

• Operating Systems: Optimized for macOS (Intel and Apple Silicon), with support for Linux and Windows.
• Go Version: Compatible with Go version 1.24 and later.
• Dependencies: Utilizes the Go standard library along with golang.org/x/term and gopkg.in/yaml.v3 for a robust performance.

Usage Examples

To launch ggc interactively:

ggc

Type to filter through commands. Navigate selections using ctrl+n and ctrl+p, and execute selected commands using Enter.

Available commands include:

• add <file> - Add a specific file to the index.
• branch create - Create and switch to a new branch.
• commit - Commit staged changes.
• log simple - Display commit logs in a simplified format.
• status - Show the current working status of the repository.

Directory Structure

main.go                  # Main entry point for ggc.
router/                  # Logic for routing commands.
cmd/                     # Handle command entry points.
git/                     # Wrappers for Git operations.

Additional Resources

For further reading, the official Git documentation provides comprehensive guides:

• Git Documentation
• Git Tutorial
• Git User Manual

For more information on installation, configuration, and additional commands, refer to the project’s README.