Quickstart for stacked pull requests

Install the gh stack extension in GitHub CLI and create your first set of stacked pull requests.

이 기사에서

참고

이 기능은 공개 미리 보기로 제공되며 변경될 수 있습니다.

Use stacked pull requests to break large code changes into a chain of smaller, dependent pull requests that you can review and merge independently.

스택은 동일한 리포지토리에 있는 일련의 끌어오기 요청으로, 각 끌어오기 요청이 아래 끌어오기 요청의 분기를 대상으로 하여 단일 분기(일반적으로 주 분기)에 배치되는 순서가 지정된 체인을 형성합니다. 하나의 큰 끌어오기 요청 대신 더 작은 끌어오기 요청 집합을 가져옵니다. 각 끌어오기 요청에는 고유한 포커스가 있는 diff가 있으므로 팀원은 각 계층을 독립적으로 검토하고 승인할 수 있습니다.

Prerequisites

  • GitHub CLI (gh) 2.90.0 or later, and Git 2.20 or later.
    • Authenticate GitHub CLI with gh auth login.
  • A GitHub repository you can push to.

Install the CLI extension

Shell
gh extension install github/gh-stack

팁

To use stacked pull requests with AI coding agents, like GitHub Copilot, install the gh-stack skill.

Shell
gh skill install github/gh-stack

Create your first stack

  1. To initialize a stack, navigate to your repository and run the following command. This creates a tracking entry and your first branch.

    Shell
    gh stack init

    You'll be prompted to name your first branch. By default, the stack uses your repository's default branch (e.g., main) as the trunk, but a stack can target any branch.

  2. Work on your first branch as usual: write code, stage changes, and commit.

    # ... write code ...
git add .
git commit -m "helpful-commit-message"

  3. When you're ready for the next logical unit of work, add a new branch to the top of the stack.

    Shell
    gh stack add BRANCH-NAME
# ... write code ...
git add .
git commit -m "Another-helpful-commit-message"

  4. Push all branches to the remote.

    Shell
    gh stack push

  5. Create pull requests and link them as a stack on GitHub.

    Shell
    gh stack submit

    Each pull request is created with the correct base branch. Your first branch targets main, and the next branch BRANCH-NAME targets the first branch. Reviewers will only see the diff for that layer. The pull requests are automatically linked together as a stack on GitHub and you can see their order and quickly navigate between them.

  6. View the stack and see the full state at any time.

    Shell
    gh stack view

    This command shows all branches, their pull request links, statuses, and the most recent commit on each.

  7. Use gh stack add -Am "MESSAGE" to stage all changes, commit, and create the next branch in one step. You won't need a separate git add or git commit. If the current branch has no commits yet, the commit lands there; if it already has commits, a new branch is created.

    # Commit lands on the current branch
gh stack add -Am "Auth middleware"

# Current branch already has commits, so this creates the next branch
gh stack add -Am "API routes"

  8. When you're ready, push everything and create the pull requests.

    Shell
    gh stack submit

Next steps