ggc — A modern Git CLI tool with an interactive search…

Pitch

Description

Comments

About this project

ggc enhances the Git experience by providing a modern command-line interface alongside an intuitive interactive search mode. Built with Go, it allows users to execute Git commands swiftly while offering a user-friendly environment that simplifies common operations. Whether executing commands directly or searching through options, ggc aims to improve productivity and ease of use.

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:

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