gg

Manage stacked diffs across GitHub and GitLab with PR/MR chains.

32|1|Updated Oct 24, 2023

Search Tags:#automation #git #github #gitlab #pull-request #stacked-diffs #gg

One-click install

npx skills add https://github.com/mrmans0n/git-gud --skill gg

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: gg
Source: https://github.com/mrmans0n/git-gud/tree/main/skills/gg
Command: npx skills add https://github.com/mrmans0n/git-gud --skill gg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

gg enables you to manage stacked diffs with GitHub PRs or GitLab MRs. Use it to create stacks, sync updates, verify CI/review state, and land approved work safely.

Core Features & Use Cases

Create/switch stacks (prefer worktrees) to isolate related changes.
View and publish stack progress with JSON-friendly outputs (gg ls --json, gg sync --json).
Navigate, amend, and reorganize commits (gg mv, gg sc, gg absorb, gg reorder, gg split).
Land workflows with guardrails, including GitLab-specific auto-merge and merge trains.
Lint, clean, and rebase to keep stacks green and tidy.

Quick Start

Set up gg, create a worktree-backed stack with gg co -w feature, commit changes, verify state with gg ls --json, and publish the stack with gg sync --json.

Frequently Asked Questions about gg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I manage stacked diffs across GitHub and GitLab?▼

You can manage stacked diffs across GitHub and GitLab by organizing dependent commits into PR/MR chains. This approach coordinates multiple interdependent changes with capabilities to create, sync, and land stacks safely.

What is the best way to create and publish a stack of dependent pull requests?▼

The best way to create and publish a stack of dependent pull requests is to isolate related changes in worktrees, commit sequentially, verify state with JSON outputs, and sync the stack to your provider.

Do I need specific CLIs to orchestrate stacked diffs with gg?▼

Yes, to orchestrate stacked diffs with gg you need the gg tool installed, an authenticated GitHub or GitLab CLI, and a repository initialized with gg to perform stack creation, synchronization, and safe landing.

Can I reorganize or amend commits within a stacked diff chain?▼

Yes, you can reorganize and amend commits within a stacked diff chain. Supported operations include moving, splitting, reordering, and absorbing commits to keep dependent PR/MR chains logically organized.

How does landing stacked diffs handle CI and review state checks?▼

Landing stacked diffs handles CI and review state checks by enforcing safety guardrails before merging. It verifies continuous integration status and review approvals, supporting GitLab-specific auto-merge and merge trains.