gh-stack

GitHub Stacked PRs

23 articles

How gh-stack Supports AI Agents Through Skills Integration

Learn how gh-stack integrates skills to empower AI agents. Execute CLI commands non-interactively with typed exit codes and safety guardrails for automated environments.

deep-dive

Aug 3, 2026

Understanding the ClientOps Interface in gh-stack: How It Wraps GitHub API Calls

Discover the ClientOps interface in gh-stack, a Go abstraction that unifies and simplifies GitHub API calls for efficient stacked PR management and testing.

deep-dive

Aug 3, 2026

How gh-stack Implements File Locking for the Stack File (.git/gh-stack.lock)

Learn how gh-stack implements file locking for .git/gh-stack.lock using advisory exclusive locks and retry logic to prevent concurrent modifications and ensure data integrity.

internals

Aug 3, 2026

gh stack unstack --local vs Regular unstack: What's the Difference?

Understand the gh stack unstack --local vs regular unstack difference. Learn when to use local-only removal versus coordinated GitHub and local updates.

deep-dive

Aug 3, 2026

How gh-stack Navigation Commands Work: up, down, top, bottom, and trunk Explained

Understand gh-stack navigation commands like up, down, top, bottom, and trunk. Learn how they treat branches as a linear stack and skip merged branches.

internals

Aug 3, 2026

gh stack sync vs rebase: Understanding the Difference in GitHub's gh-stack

Understand the difference between gh stack sync and gh stack rebase. Learn how sync updates your remote stack while rebase rearranges local commits without network ops.

deep-dive

Aug 3, 2026

gh-stack config.Config Struct and Test Overrides: Complete Configuration Guide

Explore gh-stack config.Config struct and test overrides to centralize runtime settings including I/O streams and service dependencies for deterministic testing. Learn configuration options now.

api-reference

Aug 3, 2026

How gh-stack Handles Non-Interactive Terminals and CI Environments

gh-stack ensures safe execution in CI by automatically disabling interactive prompts and TUI spinners when stdout is not a terminal. Learn how gh-stack handles non-interactive terminals.

how-to-guide

Aug 3, 2026

Understanding gh-stack Internal Architecture: A Deep Dive into cmd/, internal/, and tui/

Explore the gh-stack internal architecture: cmd for CLI, internal for core logic, and tui for interactive interfaces. Understand the separation of concerns in this Go codebase.

internals

Aug 3, 2026

How gh-stack Fetches and Checks Out Remote Stacks from GitHub: A Complete Technical Guide

Learn how gh-stack fetches and checks out remote stacks from GitHub. This guide details querying GitHub's API, reconciling local state, importing Git refs, and checking out branches.

deep-dive

Aug 3, 2026

gh stack link vs submit: Understanding the Two Ways to Manage Stacked PRs

Understand the difference between gh stack link and gh stack submit. Learn how to manage stacked PRs on GitHub using your local stack file for efficient workflow.

deep-dive

Aug 3, 2026

How gh-stack Manages Stack Updates When Base Pull Requests Are Merged

gh-stack automatically manages stack updates when base PRs merge, rebasing downstream branches to keep your linear stack in sync. Learn how it works.

how-to-guide

Aug 3, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how github/gh-stack works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →