gt-merge

name	gt-merge
description	Merge the current stack's pull requests, from trunk up to the current branch, via Graphite. Use when the user says "merge my stack" or "land these PRs" and the stack is fully reviewed and ready.
user-invocable	false

What It Does

Merges the pull requests associated with every branch from trunk up to the current branch, in one Graphite operation (gt merge). Graphite's own merge queue processes the merge; this skill previews what would merge, gets explicit confirmation, then runs it.

When to Use

• User says "merge my stack", "land these PRs", or "ship the whole stack".
• The stack is fully reviewed, CI-green, and ready to land — this is a landing operation, not a submit or a sync.

Usage

Step 1: Preview

gt log short
gt merge --dry-run

--dry-run reports which PRs would merge and makes no changes. If it reports nothing to merge (no PRs in the chain are mergeable yet — not approved, CI not green, or already merged), report that and stop.

Step 2: Confirm

Show the exact PR list from Step 1's dry run. Use AskUserQuestion: "Merge these PRs via Graphite?" with options "Merge" and "Cancel". Never proceed without an explicit yes — this lands code.

On "Cancel", stop. Nothing has run.

Step 3: Merge

gt merge -c

-c/--confirm asks for confirmation itself if local branches differ from remote — treat any such in-terminal prompt this produces as a second, independent safety check, not a redundant one to suppress.

If it fails, report the exact error output and stop. Do not retry with a different merge method, do not fall back to gh pr merge, and do not attempt a partial merge by hand.

Step 4: Report

gt log short

Report the resulting stack state: which PRs merged, which (if any) remain open above the merge point, and the current branch's status. If Graphite's merge queue can only land the stack in consecutive groups rather than atomically (visible as PRs still open above the merged point after the operation completes), report that plainly — do not claim the whole stack landed if part of it is still queued.

Boundaries

• Never calls gh pr merge for a stack — Graphite owns the merge.
• Never merges without the Step 2 confirmation.
• Never retries a failed merge automatically.