[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_1241":-5,"_1435":1436,"_1437":1438},"routes/shell",{"_1257":1258,"_1433":-5,"_1241":-5,"_27":1434},"routes/repo",{"_1251":-7,"_1252":1253,"_1254":18,"_1255":1256,"_1257":1258,"_1259":22,"_1260":22,"_1261":22,"_21":22,"_1262":22,"_1263":22,"_1264":56,"_1265":56,"_1266":22,"_1267":-7,"_1268":-7,"_1269":1270,"_1271":1272,"_1273":1274,"_34":-5,"_1275":1276,"_1277":1278,"_1279":1280,"_1281":1282},"routes/repo.changes.$number.files",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":22,"_30":31,"_32":33,"_34":-5},"actorNames",{"_1242":1250},"selections",{},"repositoryId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","change",{"_1208":1209,"_52":19,"_1210":18,"_1211":1212,"_1213":1214,"_1215":1216,"_1217":1218,"_1219":1220,"_1221":1222,"_1223":1224,"_1225":1226,"_1227":1228,"_1229":1230,"_1231":1232,"_1233":1234,"_1235":22,"_1236":22,"_1237":1238},"maintainer",false,"commits",1,"diff",{"_35":36,"_37":38,"_39":40,"_41":22},"agents",[],"computing","comments",[],"reactions",{},"viewer","old","6a4431c72e2be0c5b5d5f8e4f0ca70b927761e58","new","04294502464c07e62072e337db3f236ac3599956","files",[42,43,44,45,46,47],"truncated",{"_48":1163,"_35":-5,"_37":1164,"_52":53,"_54":1165,"_55":56,"_57":1166},{"_48":850,"_35":-5,"_37":851,"_52":53,"_54":852,"_55":56,"_57":853},{"_48":528,"_35":-5,"_37":529,"_52":53,"_54":530,"_55":56,"_57":531},{"_48":361,"_35":-5,"_37":362,"_52":53,"_54":363,"_55":56,"_57":364},{"_48":91,"_35":-5,"_37":92,"_52":53,"_54":93,"_55":56,"_57":94},{"_48":49,"_35":50,"_37":51,"_52":53,"_54":24,"_55":56,"_57":58},"path","dprint.json",{"_86":90,"_88":89},{"_86":87,"_88":89},"kind","text","add","del",0,"hunks",[59],{"_60":61,"_62":63,"_64":61,"_65":66,"_67":68},"aStart",17,"aLen",6,"bStart","bLen",7,"ops",[69,70,71,72,73,74,75],{"_76":77,"_78":85},{"_76":77,"_78":84},{"_76":77,"_78":83},{"_76":54,"_78":82},{"_76":77,"_78":81},{"_76":77,"_78":80},{"_76":77,"_78":79},"tag","eq","line","\t\t\"**/*-lock.json\",","\t\t\"**/node_modules\",","\t\t\"**/dist\",","\t\t\".agents/skills/gh-stack/**\",","\t\t\"SECURITY.md\",","\t\t\"LICENSE.md\",","\t\t\"CODE_OF_CONDUCT.md\",","oid","ab87ffa0","mode","100644","f531650f",".agents/skills/gh-stack/references/troubleshooting.md",{"_86":360,"_88":89},159,[95],{"_60":56,"_62":56,"_64":24,"_65":93,"_67":96},[97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255],{"_76":54,"_78":359},{"_76":54,"_78":258},{"_76":54,"_78":358},{"_76":54,"_78":258},{"_76":54,"_78":357},{"_76":54,"_78":356},{"_76":54,"_78":355},{"_76":54,"_78":354},{"_76":54,"_78":353},{"_76":54,"_78":352},{"_76":54,"_78":351},{"_76":54,"_78":350},{"_76":54,"_78":258},{"_76":54,"_78":349},{"_76":54,"_78":258},{"_76":54,"_78":348},{"_76":54,"_78":347},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":346},{"_76":54,"_78":345},{"_76":54,"_78":344},{"_76":54,"_78":343},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":342},{"_76":54,"_78":258},{"_76":54,"_78":341},{"_76":54,"_78":340},{"_76":54,"_78":339},{"_76":54,"_78":338},{"_76":54,"_78":258},{"_76":54,"_78":337},{"_76":54,"_78":258},{"_76":54,"_78":336},{"_76":54,"_78":335},{"_76":54,"_78":258},{"_76":54,"_78":334},{"_76":54,"_78":333},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":332},{"_76":54,"_78":331},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":330},{"_76":54,"_78":329},{"_76":54,"_78":328},{"_76":54,"_78":327},{"_76":54,"_78":258},{"_76":54,"_78":326},{"_76":54,"_78":258},{"_76":54,"_78":325},{"_76":54,"_78":324},{"_76":54,"_78":258},{"_76":54,"_78":323},{"_76":54,"_78":322},{"_76":54,"_78":321},{"_76":54,"_78":258},{"_76":54,"_78":320},{"_76":54,"_78":258},{"_76":54,"_78":319},{"_76":54,"_78":258},{"_76":54,"_78":315},{"_76":54,"_78":318},{"_76":54,"_78":317},{"_76":54,"_78":312},{"_76":54,"_78":258},{"_76":54,"_78":316},{"_76":54,"_78":258},{"_76":54,"_78":315},{"_76":54,"_78":314},{"_76":54,"_78":313},{"_76":54,"_78":312},{"_76":54,"_78":258},{"_76":54,"_78":311},{"_76":54,"_78":310},{"_76":54,"_78":309},{"_76":54,"_78":258},{"_76":54,"_78":308},{"_76":54,"_78":258},{"_76":54,"_78":307},{"_76":54,"_78":306},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":305},{"_76":54,"_78":304},{"_76":54,"_78":303},{"_76":54,"_78":302},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":301},{"_76":54,"_78":300},{"_76":54,"_78":299},{"_76":54,"_78":258},{"_76":54,"_78":298},{"_76":54,"_78":297},{"_76":54,"_78":296},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":295},{"_76":54,"_78":294},{"_76":54,"_78":293},{"_76":54,"_78":292},{"_76":54,"_78":291},{"_76":54,"_78":290},{"_76":54,"_78":289},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":288},{"_76":54,"_78":287},{"_76":54,"_78":286},{"_76":54,"_78":285},{"_76":54,"_78":258},{"_76":54,"_78":284},{"_76":54,"_78":258},{"_76":54,"_78":283},{"_76":54,"_78":282},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":281},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":280},{"_76":54,"_78":279},{"_76":54,"_78":258},{"_76":54,"_78":278},{"_76":54,"_78":258},{"_76":54,"_78":277},{"_76":54,"_78":276},{"_76":54,"_78":275},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":274},{"_76":54,"_78":273},{"_76":54,"_78":272},{"_76":54,"_78":271},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":270},{"_76":54,"_78":269},{"_76":54,"_78":258},{"_76":54,"_78":268},{"_76":54,"_78":258},{"_76":54,"_78":267},{"_76":54,"_78":266},{"_76":54,"_78":265},{"_76":54,"_78":258},{"_76":54,"_78":264},{"_76":54,"_78":258},{"_76":54,"_78":263},{"_76":54,"_78":262},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":260},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":257},{"_76":54,"_78":256},"stack on GitHub with local state.","Related: `submit` also detects a pending modify state, and under a TTY asks before overwriting the","","```","gh stack modify --abort","```bash","this state by someone else, restore it:","`gh stack modify` is TUI-only and should never be invoked by an agent. If a repository is left in","## An interrupted modify session (exit 10)","the lock; identify and stop that process before retrying.","after about five seconds, so wait and retry. A persistent exit 8 means another process still holds","Another `gh stack` process holds the exclusive lock on `.git/gh-stack.lock`. The lock times out","## Stack file is locked (exit 8)","will not work on the result. Use `gh stack checkout ` if you later want local tracking.","Because `link` writes no local state, the local navigation commands (`up`, `down`, `top`, `bottom`)","gh stack link 7 feature-d # append to existing stack #7","gh stack link 10 20 30 # by PR number","gh stack link --base develop --open a b c # non-default trunk, ready for review","gh stack link branch-a branch-b branch-c # bottom to top","where the local `.git/gh-stack` file would be wrong or absent.","Use it when branches are managed by jj, Sapling, git-town, a separate worktree, or any workflow","`gh stack link` creates and updates stacks purely through the API, with no local tracking state.","## Driving stacks from another tool or worktree","problem entirely, since they do not infer the stack from the current branch.","Then rerun. Commands that take an explicit stack number (`merge 7`, `unstack 7`) sidestep the","gh stack checkout ","trunk of more than one stack. There is no flag to disambiguate.","Commands exit 6 when the current branch cannot identify a single stack — typically because it is the","## Branch belongs to several stacks (exit 6)","`git log ..`, then replay the ranges bottom to top.","moving any branch. For a different reorder, identify each layer's range with","them, and the third replays UI-only commits above models. Preserve the old boundary SHAs before","The first rebase moves migration-only commits onto trunk, the second replays model commits above","gh stack init --base main migration models ui","gh stack unstack","git rebase --onto models \"$old_migration\" ui","git rebase --onto migration main models","git rebase --onto main \"$old_models\" migration","old_migration=$(git rev-parse migration)","old_models=$(git rev-parse models)","`main <- migration <- models <- ui`:","For example, to change `main <- models <- migration <- ui` into","Changing metadata does **not** change Git ancestry. Reorder commits first, then rebuild the stack.","re-links the stack on GitHub.","Existing PRs survive. Once Git ancestry is correct, `submit` updates their base branches and","`init` adopts branches that already exist, so the rebuild reuses them rather than creating new ones.","gh stack submit --auto # re-link on GitHub","gh stack init --base main branch-1 branch-2 branch-3","# Rename or drop branches, and rewrite ancestry as needed.","gh stack unstack # removes local tracking and the GitHub grouping","`gh stack modify`, but that is TUI-only. Tear the stack down and rebuild it instead:","There is no non-interactive reorder, rename, or removal. `add` run from the wrong branch suggests","## Restructuring a stack","stacked. If needed, clear that state before retrying.","Remote unstacking leaves PRs that are merging (auto-merge enabled) or are queued (in a merge queue)","Neither path deletes pull requests or branches."," ```"," gh stack submit --auto"," gh stack unstack # removes the grouping; PRs and branches survive"," ```bash","- **Keep the local version.** Remove the grouping on GitHub, then recreate it from local state."," gh stack checkout # or a PR number"," gh stack unstack --local # keeps the stack on GitHub","- **Keep the remote version.** Drop local tracking and pull the stack back down.","Two resolution paths:","`gh stack view --json` and compare.","`Sync aborted`. Success here does not mean the sync happened; check for that message, or re-run","When non-interactive, `sync` prints both chains, changes nothing, and exits **0** with","branches were added locally while a PR was added to the stack on github.com.","Divergence means the local stack and the stack on GitHub changed in different ways — for example","## Local and remote stacks have diverged","merged PRs.","and then `--continue` until complete. Use `gh stack sync --prune` to also delete local branches for","Run `gh stack rebase` to rerun the rebase, which will stop at the conflict and allow you to resolve","No manual action is needed. If the replay conflicts, `sync` restores all branches and exits 3.","gh stack view --json # merged branch reports \"isMerged\": true, \"state\": \"MERGED\"","gh stack sync","merged branch:","`gh stack sync` detects this and rebases with `--onto` against the correct target, skipping the","in the trunk's history and an ordinary rebase would try to replay them again.","A squash merge replaces the branch's commits with one new commit, so the originals no longer exist","## After a squash merge","affected layer.","every branch above it. Without `rerere`, repeated conflicts may need manual resolution on each","time the same conflict appears — which is common, since a change low in the stack is rebased through","Because `init` enables `git rerere`, a conflict you resolve once is replayed automatically the next","`gh stack rebase --abort` restores every branch in the stack, not just the current one.","gh stack rebase --continue # repeat if the next branch also conflicts","git add ","# exit 3 — conflicted paths are listed on stderr","gh stack rebase","first, so a failed `sync` leaves nothing half-applied; a failed `rebase` stops mid-flight and waits.","`rebase` and `sync` both exit 3 on conflict. `sync` restores every branch to its pre-rebase state","## Rebase conflicts (exit 3)","- [An interrupted modify session (exit 10)](#an-interrupted-modify-session-exit-10)","- [Stack file is locked (exit 8)](#stack-file-is-locked-exit-8)","- [Driving stacks from another tool or worktree](#driving-stacks-from-another-tool-or-worktree)","- [Branch belongs to several stacks (exit 6)](#branch-belongs-to-several-stacks-exit-6)","- [Restructuring a stack](#restructuring-a-stack)","- [Local and remote stacks have diverged](#local-and-remote-stacks-have-diverged)","- [After a squash merge](#after-a-squash-merge)","- [Rebase conflicts (exit 3)](#rebase-conflicts-exit-3)","## Contents","# Troubleshooting and recovery","fc97b41a",".agents/skills/gh-stack/references/stack-design.md",{"_86":527,"_88":89},97,[365],{"_60":56,"_62":56,"_64":24,"_65":363,"_67":366},[367,368,369,370,371,372,373,374,375,376,377,378,379,380,381,382,383,384,385,386,387,388,389,390,391,392,393,394,395,396,397,398,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,419,420,421,422,423,424,425,426,427,428,429,430,431,432,433,434,435,436,437,438,439,440,441,442,443,444,445,446,447,448,449,450,451,452,453,454,455,456,457,458,459,460,461,462,463],{"_76":54,"_78":526},{"_76":54,"_78":258},{"_76":54,"_78":525},{"_76":54,"_78":258},{"_76":54,"_78":358},{"_76":54,"_78":258},{"_76":54,"_78":524},{"_76":54,"_78":523},{"_76":54,"_78":522},{"_76":54,"_78":521},{"_76":54,"_78":520},{"_76":54,"_78":258},{"_76":54,"_78":519},{"_76":54,"_78":258},{"_76":54,"_78":518},{"_76":54,"_78":517},{"_76":54,"_78":516},{"_76":54,"_78":515},{"_76":54,"_78":258},{"_76":54,"_78":514},{"_76":54,"_78":258},{"_76":54,"_78":259},{"_76":54,"_78":513},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":512},{"_76":54,"_78":511},{"_76":54,"_78":510},{"_76":54,"_78":509},{"_76":54,"_78":258},{"_76":54,"_78":508},{"_76":54,"_78":507},{"_76":54,"_78":258},{"_76":54,"_78":506},{"_76":54,"_78":505},{"_76":54,"_78":258},{"_76":54,"_78":504},{"_76":54,"_78":258},{"_76":54,"_78":503},{"_76":54,"_78":502},{"_76":54,"_78":501},{"_76":54,"_78":500},{"_76":54,"_78":258},{"_76":54,"_78":499},{"_76":54,"_78":498},{"_76":54,"_78":258},{"_76":54,"_78":497},{"_76":54,"_78":496},{"_76":54,"_78":258},{"_76":54,"_78":495},{"_76":54,"_78":258},{"_76":54,"_78":494},{"_76":54,"_78":493},{"_76":54,"_78":492},{"_76":54,"_78":491},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":490},{"_76":54,"_78":489},{"_76":54,"_78":258},{"_76":54,"_78":488},{"_76":54,"_78":487},{"_76":54,"_78":486},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":485},{"_76":54,"_78":484},{"_76":54,"_78":258},{"_76":54,"_78":483},{"_76":54,"_78":482},{"_76":54,"_78":258},{"_76":54,"_78":481},{"_76":54,"_78":258},{"_76":54,"_78":480},{"_76":54,"_78":479},{"_76":54,"_78":258},{"_76":54,"_78":478},{"_76":54,"_78":477},{"_76":54,"_78":476},{"_76":54,"_78":258},{"_76":54,"_78":475},{"_76":54,"_78":258},{"_76":54,"_78":474},{"_76":54,"_78":258},{"_76":54,"_78":473},{"_76":54,"_78":472},{"_76":54,"_78":258},{"_76":54,"_78":471},{"_76":54,"_78":470},{"_76":54,"_78":258},{"_76":54,"_78":469},{"_76":54,"_78":468},{"_76":54,"_78":467},{"_76":54,"_78":466},{"_76":54,"_78":258},{"_76":54,"_78":465},{"_76":54,"_78":464},"deserves its own stack.","A trivial incidental fix can ride along in the current stack. Once it grows into its own project, it","stacks.","Use `gh stack init` for the new effort, or `gh stack checkout ` to move between existing","independent refactor. Do not mix efforts into one stack just because you happened to work on both.","**Start a separate stack** for unrelated work — a different feature, an unrelated bug fix, an","different concerns.","**Use a single stack** when every branch serves the same feature or project, even if the layers span","feature being built.","A stack should read as a coherent progression: a reviewer walks the PRs bottom to top and sees the","## One stack, one story","A layer that cannot be described in one sentence is usually two layers.","- The current branch's diff is already large enough to review on its own","- The next changes have a different reviewer audience","- Moving from backend to frontend, or from core logic to tests or documentation","Signals:","Add a branch when you start a **different concern that depends on what you have built so far**.","## When to add a layer","changes carry over to the new branch. Commit or stash first if you want the new layer to start clean.","Note that `gh stack add ` without `-Am` does not touch the working tree, so uncommitted","concern, and that a change belonging to a different concern goes in a different branch.","Multiple commits per branch are fine. What matters is that every commit in a branch serves the same","git commit -m \"Add user API routes\"","git add internal/api/routes.go internal/api/handlers.go","gh stack add api-routes","git commit -m \"Add user and session models\"","git add internal/models/user.go internal/models/session.go","there:","subset that belongs to the current layer, commit it, then create the next branch and stage the rest","over which changes land in which branch. With several modified files in the working tree, stage the","Use `git add` and `git commit` directly rather than the `add -Am` shortcut. The point is control","## Staging changes deliberately","date-and-slug form (for example `03-24-add_api_routes`). Prefer naming the branch yourself.","If you pass `-m` without a branch name, the name is generated from the commit message in","`gh stack add refactor/foo` creates a branch literally named `refactor/foo`.","Names are used exactly as given — nothing is prepended or transformed, and slashes are kept, so","stack. **User and repository branch naming conventions take precedence; follow them instead.**","This keeps related branches recognizable without using generic names that could belong to any","`/` — for example, `billing/schema`, `billing/api`, `billing/ui`.","Prefer a shared topic prefix plus the layer's concern:","## Branch naming","If a task is large enough to warrant a stack, create the stack at the start.","The failure mode to avoid is writing everything on one branch and trying to split it afterwards.","`todo-app` or these layer names literally.","This is illustrative. Infer the stack topic and layer names from the actual task; do not reuse","- `todo-app/integration` — tests exercising the whole feature","- `todo-app/frontend` — components that call the routes","- `todo-app/api` — routes that use the models","- `todo-app/models` — shared types and schema","(main) <- todo-app/models <- todo-app/api <- todo-app/frontend <- todo-app/integration","Decide the layers first, then write code into them:","means`unstack` and `init` again.","by restructuring later, because there is no non-interactive in-place reorder — fixing the order","live in the same branch or a lower one. That constraint is much cheaper to satisfy by planning than","A stack is a dependency chain. If code in one layer depends on code in another, the dependency must","## Plan the layers before writing code","- [One stack, one story](#one-stack-one-story)","- [When to add a layer](#when-to-add-a-layer)","- [Staging changes deliberately](#staging-changes-deliberately)","- [Branch naming](#branch-naming)","- [Plan the layers before writing code](#plan-the-layers-before-writing-code)","How to decide what goes in each layer. Read this before running `gh stack init`.","# Designing a stack","f64543ac",".agents/skills/gh-stack/references/commands.md",{"_86":849,"_88":89},177,[532],{"_60":56,"_62":56,"_64":24,"_65":530,"_67":533},[534,535,536,537,538,539,540,541,542,543,544,545,546,547,548,549,550,551,552,553,554,555,556,557,558,559,560,561,562,563,564,565,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581,582,583,584,585,586,587,588,589,590,591,592,593,594,595,596,597,598,599,600,601,602,603,604,605,606,607,608,609,610,611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641,642,643,644,645,646,647,648,649,650,651,652,653,654,655,656,657,658,659,660,661,662,663,664,665,666,667,668,669,670,671,672,673,674,675,676,677,678,679,680,681,682,683,684,685,686,687,688,689,690,691,692,693,694,695,696,697,698,699,700,701,702,703,704,705,706,707,708,709,710],{"_76":54,"_78":848},{"_76":54,"_78":258},{"_76":54,"_78":847},{"_76":54,"_78":846},{"_76":54,"_78":258},{"_76":54,"_78":358},{"_76":54,"_78":258},{"_76":54,"_78":845},{"_76":54,"_78":844},{"_76":54,"_78":843},{"_76":54,"_78":842},{"_76":54,"_78":841},{"_76":54,"_78":840},{"_76":54,"_78":839},{"_76":54,"_78":838},{"_76":54,"_78":837},{"_76":54,"_78":836},{"_76":54,"_78":835},{"_76":54,"_78":834},{"_76":54,"_78":258},{"_76":54,"_78":833},{"_76":54,"_78":258},{"_76":54,"_78":832},{"_76":54,"_78":831},{"_76":54,"_78":258},{"_76":54,"_78":830},{"_76":54,"_78":829},{"_76":54,"_78":828},{"_76":54,"_78":827},{"_76":54,"_78":258},{"_76":54,"_78":826},{"_76":54,"_78":825},{"_76":54,"_78":258},{"_76":54,"_78":824},{"_76":54,"_78":258},{"_76":54,"_78":823},{"_76":54,"_78":822},{"_76":54,"_78":821},{"_76":54,"_78":820},{"_76":54,"_78":819},{"_76":54,"_78":818},{"_76":54,"_78":817},{"_76":54,"_78":816},{"_76":54,"_78":815},{"_76":54,"_78":258},{"_76":54,"_78":814},{"_76":54,"_78":258},{"_76":54,"_78":813},{"_76":54,"_78":812},{"_76":54,"_78":258},{"_76":54,"_78":811},{"_76":54,"_78":810},{"_76":54,"_78":258},{"_76":54,"_78":809},{"_76":54,"_78":258},{"_76":54,"_78":808},{"_76":54,"_78":258},{"_76":54,"_78":807},{"_76":54,"_78":806},{"_76":54,"_78":258},{"_76":54,"_78":805},{"_76":54,"_78":804},{"_76":54,"_78":803},{"_76":54,"_78":802},{"_76":54,"_78":801},{"_76":54,"_78":800},{"_76":54,"_78":799},{"_76":54,"_78":798},{"_76":54,"_78":797},{"_76":54,"_78":796},{"_76":54,"_78":795},{"_76":54,"_78":794},{"_76":54,"_78":258},{"_76":54,"_78":793},{"_76":54,"_78":258},{"_76":54,"_78":792},{"_76":54,"_78":791},{"_76":54,"_78":258},{"_76":54,"_78":790},{"_76":54,"_78":789},{"_76":54,"_78":788},{"_76":54,"_78":787},{"_76":54,"_78":786},{"_76":54,"_78":785},{"_76":54,"_78":784},{"_76":54,"_78":783},{"_76":54,"_78":782},{"_76":54,"_78":258},{"_76":54,"_78":781},{"_76":54,"_78":258},{"_76":54,"_78":780},{"_76":54,"_78":258},{"_76":54,"_78":779},{"_76":54,"_78":778},{"_76":54,"_78":777},{"_76":54,"_78":776},{"_76":54,"_78":775},{"_76":54,"_78":774},{"_76":54,"_78":773},{"_76":54,"_78":772},{"_76":54,"_78":771},{"_76":54,"_78":770},{"_76":54,"_78":769},{"_76":54,"_78":768},{"_76":54,"_78":767},{"_76":54,"_78":766},{"_76":54,"_78":258},{"_76":54,"_78":765},{"_76":54,"_78":258},{"_76":54,"_78":764},{"_76":54,"_78":763},{"_76":54,"_78":258},{"_76":54,"_78":762},{"_76":54,"_78":761},{"_76":54,"_78":760},{"_76":54,"_78":759},{"_76":54,"_78":758},{"_76":54,"_78":757},{"_76":54,"_78":756},{"_76":54,"_78":755},{"_76":54,"_78":754},{"_76":54,"_78":258},{"_76":54,"_78":753},{"_76":54,"_78":258},{"_76":54,"_78":752},{"_76":54,"_78":751},{"_76":54,"_78":750},{"_76":54,"_78":749},{"_76":54,"_78":748},{"_76":54,"_78":747},{"_76":54,"_78":258},{"_76":54,"_78":746},{"_76":54,"_78":258},{"_76":54,"_78":745},{"_76":54,"_78":258},{"_76":54,"_78":744},{"_76":54,"_78":743},{"_76":54,"_78":742},{"_76":54,"_78":741},{"_76":54,"_78":740},{"_76":54,"_78":739},{"_76":54,"_78":258},{"_76":54,"_78":738},{"_76":54,"_78":258},{"_76":54,"_78":737},{"_76":54,"_78":258},{"_76":54,"_78":736},{"_76":54,"_78":735},{"_76":54,"_78":734},{"_76":54,"_78":733},{"_76":54,"_78":732},{"_76":54,"_78":731},{"_76":54,"_78":730},{"_76":54,"_78":258},{"_76":54,"_78":729},{"_76":54,"_78":258},{"_76":54,"_78":728},{"_76":54,"_78":727},{"_76":54,"_78":726},{"_76":54,"_78":725},{"_76":54,"_78":724},{"_76":54,"_78":723},{"_76":54,"_78":722},{"_76":54,"_78":721},{"_76":54,"_78":720},{"_76":54,"_78":719},{"_76":54,"_78":718},{"_76":54,"_78":717},{"_76":54,"_78":716},{"_76":54,"_78":258},{"_76":54,"_78":715},{"_76":54,"_78":258},{"_76":54,"_78":714},{"_76":54,"_78":713},{"_76":54,"_78":712},{"_76":54,"_78":258},{"_76":54,"_78":711},"`gh stack switch` is a selection menu with no non-interactive path. Use the commands above instead.","navigating from an active branch, so `bottom` lands on the lowest *unmerged* branch.","count (`gh stack up 3`). Movement clamps at the stack bounds, and merged branches are skipped when","`up`, `down`, `top`, `bottom`, and `trunk` are always non-interactive. `up` and `down` accept a","## Navigation","- `gh pr merge` cannot merge a stack. Always use `gh stack merge`."," in separate groups rather than all at once."," warning. Queued PRs are submitted together but land as the queue processes them, so they may merge"," than merged; the queue chooses the method and any method flag you passed is ignored with a","- **A merge queue on the base branch overrides everything.** The stack is added to the queue rather"," is not supported for stacks.","- Only basic PR state is checked before merging: open and not a draft. Bypassing merge requirements"," one, the last-used method is reused.","- The method comes from `--squash`, `--rebase`, `--merge`, or `--merge-method `. Without"," is reported.","- **All-or-nothing.** If any PR in that exact merge set cannot be merged, none are, and the reason"," stack, or pass a stack number to merge every unmerged PR in that stack.","- Scope with an argument: pass a PR number to merge that PR and every unmerged PR below it in the","## merge","- An unknown stack number exits **2**."," number that is not tracked locally is an error.","- `--local` removes local tracking only and never contacts GitHub. Combining `--local` with a stack"," Local tracking is also removed when present.","- With a stack number it works from anywhere in the repository, tracked locally or not, via the API."," it on GitHub and locally.","- With no argument it targets the active stack — the one containing the current branch — removing","Removes the stack **grouping** only. It never deletes pull requests or branches.","## unstack","- `checkout` has no flags. It relies on `remote.pushDefault` when several remotes exist."," cannot be forced past it. Run `gh stack unstack --local` first, then retry.","- If a local stack already exists over those branches with a different composition, `checkout`"," stack up locally.","- Stack numbers, PR numbers, and PR URLs fetch from GitHub, pull the branches down, and set the","- A bare number resolves as a **stack number first**, then a PR number, then a branch name.","Accepts a stack number, PR number, PR URL, or branch name.","## checkout"," API is unreachable.","- `view` refreshes PR state from GitHub as a side effect, best-effort — it does not fail when the"," formatted for humans; parse `--json` instead.","- `--short` prints a compact one-line-per-branch summary and never opens the TUI, but it is","- Bare `view` opens a full-screen TUI when stdout is a TTY, and prints static text when piped.","- `--json` writes the machine-readable payload to stdout. Its schema is in `SKILL.md`.","## view","- Starting a rebase while one is in progress exits **7**."," squash-merged parent does not produce spurious conflicts.","- A merged PR is detected automatically and replayed with `--onto` against the correct target, so a","- `--continue` after staging resolutions; `--abort` restores every branch."," other only.","- `--no-trunk` skips fetching and the trunk rebase entirely, aligning stack branches with each","- `--downstack` rebases from the trunk to the current branch."," lower layer.","- `--upstack` rebases from the current branch to the top. This is what you run after editing a","to rebase only part of the stack.","Pulls from the remote and cascade-rebases. Use it when `sync` reported a conflict or when you need","## rebase"," environment.","8. **Prune** local branches for merged PRs, only when `--prune` is passed in a non-interactive"," exist. `sync` never opens PRs; that is `submit`.","7. **Sync the stack object** — link open PRs into a stack, additively. Only when two or more PRs","6. **Refresh PR state** from GitHub.","5. **Push** all active branches, atomically."," command exits **3**."," automatically. On conflict, **all branches are restored** to their pre-rebase state and the"," from its remote, or a branch no longer contains its expected parent. Merged PRs are handled","4. **Cascade rebase when needed.** This runs if the trunk moved, a stack branch was fast-forwarded","3. **Fast-forward the trunk.** Skipped when already current; warns when diverged."," appended locally. On divergence, aborts when non-interactive (see `troubleshooting.md`).","2. **Reconcile with the GitHub stack.** PRs added to the stack on github.com are pulled down and","1. **Fetch** from the remote.","The routine command. Steps, in order:","## sync","- Stack membership is **additive only** — `link` never removes a PR from a stack."," auto-generated titles and correctly chained bases; existing PRs with a wrong base are corrected.","- Branch arguments are pushed automatically (non-force, atomic). Missing PRs are created with"," skipped; arguments belonging to a different stack are rejected."," not re-list its current PRs: `gh stack link 7 feature-c`. Arguments already in the stack are"," exists.** In that case the remaining arguments are appended to the top of that stack and you do","- **A numeric first argument is treated as a stack number only when a stack with that number"," tried as a PR number first and falls back to a branch name.","- Arguments are given bottom to top. Each is a branch name or a PR number; a numeric argument is","branches managed by another tool or living in another worktree — see `troubleshooting.md`.","Creates or updates a stack on GitHub **without any local tracking state**. This is the path for","## link"," non-interactive (under a TTY it offers to create ordinary unstacked PRs instead).","- Requires stacked PRs to be enabled on the repository. If not, `submit` exits **9** when","- `--open` marks new *and existing* PRs ready for review; without it new PRs are drafts."," `gh pr edit` afterwards."," (hyphens and underscores become spaces). There is no flag for a custom title or body; use"," the title and its body as the PR body. A branch with multiple commits humanizes the branch name","- **Title generation with `--auto`:** a branch with a single commit uses that commit's subject as"," it on GitHub, leaving the merged stack untouched."," `submit` forks the remaining unmerged branches into a **new** stack rooted at the trunk and creates","- **A fully merged stack cannot be extended.** When every PR in the current stack is already merged,"," push is rejected, earlier pushes and PR updates stand. Fix the rejection and rerun the same command.","- **Not atomic.** Branches are pushed sequentially with per-branch `--force-with-lease`. If a later","first non-merged ancestor, then links them into a Stack on GitHub.","Pushes each active branch, then creates a PR for every branch that lacks one, basing it on the","## submit","`push` never creates or updates pull requests. Use `submit` for that.","moved on the remote; fix that branch and rerun — rerunning is safe and skips what already landed.","**Not atomic.** Some branches may update while another is rejected. A rejection means that branch","`--force-with-lease`.","Pushes every active (non-merged, non-queued) branch in one multi-ref push with per-branch","## push","- `-A` and `-u` are mutually exclusive, and both require `-m`."," usually needs its content before a second layer exists."," immediately after `init` — instead of creating a branch. This is deliberate: the first layer","- **`add -Am` commits in place when the current branch has no commits yet** — for example"," staged and unstaged changes follow you onto the new branch. Commit or stash first for a clean start.","- **Uncommitted changes carry over.** Without `-Am`, `add` does not touch the working tree, so"," first."," Anywhere else it exits **5** with `can only add branches on top of the stack`. Run `gh stack top`","- **Must run from the top branch** of the stack (or the trunk when the stack is still empty).","## add","`git config rerere.enabled true` beforehand to skip it.","`init` also enables `git rerere`. Under a TTY the first run in a repo asks for confirmation; set","selects a non-default trunk.","branch immediately before it. There is no separate adopt mode — existence decides. `--base`","branch does not exist, it is created from the trunk; each later new branch is created from the","`init` processes branch arguments from bottom to top. Existing branches are adopted. If the first","the whole chain: `gh stack init auth api frontend`.","Creates the stack and checks out the **last** branch in the list, so a single `init` can lay down","## init","- [Navigation](#navigation)","- [merge](#merge)","- [unstack](#unstack)","- [checkout](#checkout)","- [view](#view)","- [rebase](#rebase)","- [sync](#sync)","- [link](#link)","- [submit](#submit)","- [push](#push)","- [add](#add)","- [init](#init)","explain: preconditions, side effects, atomicity, and failure modes.","`gh stack --help` is authoritative for flags and arguments. (`gh stack help ` only prints the top-level help.) This file only covers behavior `--help` does not","# Command behavior","fcb219a5",".agents/skills/gh-stack/SKILL.md",{"_86":1162,"_88":89},181,[854],{"_60":56,"_62":56,"_64":24,"_65":852,"_67":855},[856,857,858,859,860,861,862,863,864,865,866,867,868,869,870,871,872,873,874,875,876,877,878,879,880,881,882,883,884,885,886,887,888,889,890,891,892,893,894,895,896,897,898,899,900,901,902,903,904,905,906,907,908,909,910,911,912,913,914,915,916,917,918,919,920,921,922,923,924,925,926,927,928,929,930,931,932,933,934,935,936,937,938,939,940,941,942,943,944,945,946,947,948,949,950,951,952,953,954,955,956,957,958,959,960,961,962,963,964,965,966,967,968,969,970,971,972,973,974,975,976,977,978,979,980,981,982,983,984,985,986,987,988,989,990,991,992,993,994,995,996,997,998,999,1000,1001,1002,1003,1004,1005,1006,1007,1008,1009,1010,1011,1012,1013,1014,1015,1016,1017,1018,1019,1020,1021,1022,1023,1024,1025,1026,1027,1028,1029,1030,1031,1032,1033,1034,1035,1036],{"_76":54,"_78":1152},{"_76":54,"_78":1161},{"_76":54,"_78":1160},{"_76":54,"_78":1159},{"_76":54,"_78":1158},{"_76":54,"_78":1157},{"_76":54,"_78":1156},{"_76":54,"_78":1155},{"_76":54,"_78":1154},{"_76":54,"_78":1153},{"_76":54,"_78":1152},{"_76":54,"_78":258},{"_76":54,"_78":1151},{"_76":54,"_78":258},{"_76":54,"_78":1150},{"_76":54,"_78":1149},{"_76":54,"_78":1148},{"_76":54,"_78":258},{"_76":54,"_78":1147},{"_76":54,"_78":258},{"_76":54,"_78":259},{"_76":54,"_78":1146},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1145},{"_76":54,"_78":1144},{"_76":54,"_78":1143},{"_76":54,"_78":1142},{"_76":54,"_78":258},{"_76":54,"_78":1141},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":1140},{"_76":54,"_78":1139},{"_76":54,"_78":1138},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1137},{"_76":54,"_78":258},{"_76":54,"_78":1136},{"_76":54,"_78":1135},{"_76":54,"_78":1134},{"_76":54,"_78":258},{"_76":54,"_78":1133},{"_76":54,"_78":1132},{"_76":54,"_78":1131},{"_76":54,"_78":258},{"_76":54,"_78":1130},{"_76":54,"_78":1068},{"_76":54,"_78":1129},{"_76":54,"_78":1128},{"_76":54,"_78":1127},{"_76":54,"_78":1126},{"_76":54,"_78":1125},{"_76":54,"_78":1124},{"_76":54,"_78":1123},{"_76":54,"_78":1122},{"_76":54,"_78":258},{"_76":54,"_78":1121},{"_76":54,"_78":1120},{"_76":54,"_78":1119},{"_76":54,"_78":258},{"_76":54,"_78":1118},{"_76":54,"_78":258},{"_76":54,"_78":1117},{"_76":54,"_78":1116},{"_76":54,"_78":1115},{"_76":54,"_78":1114},{"_76":54,"_78":1113},{"_76":54,"_78":1112},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":1111},{"_76":54,"_78":1110},{"_76":54,"_78":1109},{"_76":54,"_78":1108},{"_76":54,"_78":1107},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1106},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":1105},{"_76":54,"_78":1104},{"_76":54,"_78":1103},{"_76":54,"_78":1102},{"_76":54,"_78":1101},{"_76":54,"_78":1100},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1099},{"_76":54,"_78":1098},{"_76":54,"_78":258},{"_76":54,"_78":1097},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":1096},{"_76":54,"_78":1095},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1094},{"_76":54,"_78":1093},{"_76":54,"_78":1092},{"_76":54,"_78":258},{"_76":54,"_78":1091},{"_76":54,"_78":258},{"_76":54,"_78":1090},{"_76":54,"_78":258},{"_76":54,"_78":261},{"_76":54,"_78":1089},{"_76":54,"_78":1088},{"_76":54,"_78":1087},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1086},{"_76":54,"_78":1085},{"_76":54,"_78":1084},{"_76":54,"_78":258},{"_76":54,"_78":1083},{"_76":54,"_78":1082},{"_76":54,"_78":1081},{"_76":54,"_78":258},{"_76":54,"_78":1080},{"_76":54,"_78":258},{"_76":54,"_78":1079},{"_76":54,"_78":1078},{"_76":54,"_78":258},{"_76":54,"_78":259},{"_76":54,"_78":1077},{"_76":54,"_78":1076},{"_76":54,"_78":1075},{"_76":54,"_78":1074},{"_76":54,"_78":259},{"_76":54,"_78":258},{"_76":54,"_78":1073},{"_76":54,"_78":1072},{"_76":54,"_78":1071},{"_76":54,"_78":258},{"_76":54,"_78":1070},{"_76":54,"_78":258},{"_76":54,"_78":1069},{"_76":54,"_78":1068},{"_76":54,"_78":1067},{"_76":54,"_78":1066},{"_76":54,"_78":1065},{"_76":54,"_78":1064},{"_76":54,"_78":1063},{"_76":54,"_78":1062},{"_76":54,"_78":1061},{"_76":54,"_78":1060},{"_76":54,"_78":1059},{"_76":54,"_78":1058},{"_76":54,"_78":1057},{"_76":54,"_78":258},{"_76":54,"_78":1056},{"_76":54,"_78":258},{"_76":54,"_78":1055},{"_76":54,"_78":1054},{"_76":54,"_78":1053},{"_76":54,"_78":1052},{"_76":54,"_78":258},{"_76":54,"_78":1051},{"_76":54,"_78":258},{"_76":54,"_78":1050},{"_76":54,"_78":1049},{"_76":54,"_78":1048},{"_76":54,"_78":1047},{"_76":54,"_78":258},{"_76":54,"_78":1046},{"_76":54,"_78":258},{"_76":54,"_78":1045},{"_76":54,"_78":1044},{"_76":54,"_78":258},{"_76":54,"_78":1043},{"_76":54,"_78":258},{"_76":54,"_78":1042},{"_76":54,"_78":1041},{"_76":54,"_78":1040},{"_76":54,"_78":1039},{"_76":54,"_78":1038},{"_76":54,"_78":1037}," remote divergence, when restructuring a stack, or when driving stacks from another tool.","- `references/troubleshooting.md` — read on a rebase conflict, after a squash-merge, on local and"," side effects, atomicity, or ordering guarantees.","- `references/commands.md` — read when a command fails unexpectedly or you need its preconditions,"," use, what belongs in each one, or whether work belongs in a new stack.","- `references/stack-design.md` — read before creating a stack, when deciding how many layers to","Open the reference whose trigger matches the task; no need to preload all three.","`gh stack help ` does **not** work — it prints the top-level help.","`gh stack --help` is authoritative for flags and arguments. Note that","## More detail","- PR titles and bodies are auto-generated. Use `gh pr edit` afterwards to change them."," TUI-only — restructure with `unstack` then `init` instead.","- There is no non-interactive reorder or removal. Errors may suggest `gh stack modify`, but it is","- Stacks are strictly linear: one parent, at most one child. Use separate stacks for parallel work.","## Constraints"," conflict, then resolve and continue as above.","- After `gh stack sync`: the stack has already been restored. Run `gh stack rebase` to recreate the"," `gh stack rebase --continue`; use `gh stack rebase --abort` to restore the stack.","- After `gh stack rebase`: resolve the files, run `git add`, then","**Exit 3 recovery:**","| 10 | Modify recovery required | `gh stack modify --abort` |","| 9 | Stacked PRs unavailable | Not enabled on the repository; tell the user |","| 8 | Stack file locked | Another `gh stack` process is writing; retry after ~5s |","| 7 | Rebase already in progress | `gh stack rebase --continue` or `--abort` |","| 6 | Disambiguation required | Branch is in several stacks; check out a non-shared branch |","| 5 | Invalid arguments | Fix the invocation; see ` --help` |","| 4 | GitHub API failure | Check `gh auth status`, retry |","| 3 | Rebase conflict | Follow the Exit 3 recovery below |","| 2 | Not in a stack | `gh stack init`, or `gh stack checkout ` |","| 1 | Generic error | Read stderr |","| 0 | Success | — |","|---|---|---|","| Code | Meaning | Recovery |","## Exit codes","an ancestor of the branch.","older than the parent's current tip. `needsRebase` is true when the current parent tip is no longer","`base` is the saved SHA of the parent branch that this branch was last known to contain. It may be","branches[].pr number, url, state (\"OPEN\" | \"MERGED\" | \"QUEUED\"); absent when no PR exists","branches[] name, head, base, isCurrent, isMerged, isQueued, needsRebase","currentBranch string","trunk string","them, branch on exit codes instead.","`gh stack view --json` writes JSON to **stdout**. Status messages go to **stderr** — do not parse","## Reading state","warning; queued PRs may land in separate groups.","stack is queued instead and the queue picks the method, ignoring any flag you passed with a","Without a method flag the last-used method is reused. If the base branch uses a merge queue, the","none do.","unmerged PR in that stack. The operation is all-or-nothing: if any PR in that set cannot merge,","Pass a PR number to merge that PR and every unmerged PR below it, or a stack number to merge every","gh stack merge 42 --yes --squash # or --merge, --rebase, --merge-method ","gh stack merge 7 --yes # every unmerged PR in stack #7","gh stack merge 42 --yes # PR #42 plus every unmerged PR below it","Scope the merge with an argument:","## Merging","`references/troubleshooting.md`.","diverged, `sync` prints both chains, makes no changes, and exits 0 with `Sync aborted` — see","Pruning never happens without `--prune` when non-interactive. If the local and remote stacks have","gh stack sync --prune # also delete local branches for merged PRs","gh stack sync # fetch, reconcile with GitHub, rebase, push, refresh PR state","## Staying in sync","verbatim — `gh stack add refactor/foo` creates `refactor/foo`.","Add `--open` to `submit` to create PRs ready for review instead of drafts. Branch names are","gh stack view --json # confirm","gh stack submit --auto # push every branch and open draft PRs","git add ... && git commit -m \"Add API routes\"","gh stack add api # next layer, branched from the current one","git add ... && git commit -m \"Add auth middleware\"","gh stack init auth # create the stack and check out its branch","## Core loop","gh stack push","gh stack top # return to where you were","gh stack rebase --upstack # replay every branch above onto the change","git add ... && git commit -m \"Add get-user endpoint\"","gh stack down # or: gh stack checkout api"," rebase upstack, and return to top."," ownership is unclear, inspect `git log --all -- `. Then check out the owner, edit, commit,"," commit a lower layer's concern on the current top branch. Run `gh stack view --json`; if","- **Editing an existing stack:** check out the layer that owns the change before editing. Never"," concern on trunk and split it later. Put one dependent concern in each layer, bottom to top.","- **Starting multi-part work:** create the stack before writing files. Do not implement every","## Branch placement"," Run `gh stack unstack --local` first (this keeps the stack on GitHub), then retry.","- **`checkout ` when a different local stack already covers those branches** cannot be forced.","- `view --short` is safe in both modes, but it is formatted for humans. Use `--json` to parse.","| — | `gh stack modify` | TUI-only, no non-interactive path |","| `gh stack up` / `down` / `top` / `bottom` | `gh stack switch` | `switch` is menu-only |","| `gh stack checkout ` | `gh stack checkout` | opens a selection menu |","| `gh stack add ` | `gh stack add` | prompts for a name, and fails even when piped |","| `gh stack init ...` | `gh stack init` | prompts for branch names |","| `gh stack merge --yes` | `gh pr merge` | `gh pr merge` cannot merge a stack |","| `gh stack submit --auto` | `gh stack submit` | prompts for a title per new PR |","| `gh stack view --json` | `gh stack view` | opens a TUI under a PTY |","| Always run | Never run bare | Why |","`--remote` flag and require the config.","`--remote ` unless `remote.pushDefault` is configured. `checkout` and `trunk` have no","**Multiple remotes:** never run `push`, `submit`, `sync`, `rebase`, or `link` without","Agent harnesses differ, so always pass the flags below instead of relying on that detection.","static text; under a PTY the same commands open a prompt or a full-screen TUI and block forever.","`gh stack` branches on whether **stdout is a TTY**. Piped, most commands error cleanly or print","## Non-interactive use","git config remote.pushDefault origin # required if the repo has more than one remote","git config rerere.enabled true # remember conflict resolutions","gh extension install github/gh-stack","## Setup","layers, read `references/stack-design.md`.","Foundational work belongs at the bottom, code that depends on it above. For how to choose the","`frontend` merges last. `up` moves toward the top, away from trunk; `down` moves toward it.","Left is the **bottom**, right is the **top**. `auth` is based on `main` and merges first;","(main) <- auth <- api <- frontend","`gh stack` prints a stack trunk-first, left to right:","based on the branch below it, so a reviewer sees only that layer's diff.","requests. A stack is an ordered chain of branches rooted on a trunk, where each branch has one PR","`gh stack` is a [GitHub CLI](https://cli.github.com/) extension for stacked branches and pull","# gh-stack","---"," version: \"0.1.0\""," author: github","metadata:"," branch layers, dependent PRs, or gh stack; or when a stack is checked out."," when asked to split or isolate work for review; whenever a user mentions a stack,"," Use for stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout;"," Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack.","description: >","name: gh-stack","bb754968",".agents/skills/gh-stack/LICENSE",{"_86":1207,"_88":89},21,[1167],{"_60":56,"_62":56,"_64":24,"_65":1165,"_67":1168},[1169,1170,1171,1172,1173,1174,1175,1176,1177,1178,1179,1180,1181,1182,1183,1184,1185,1186,1187,1188,1189],{"_76":54,"_78":1206},{"_76":54,"_78":258},{"_76":54,"_78":1205},{"_76":54,"_78":258},{"_76":54,"_78":1204},{"_76":54,"_78":1203},{"_76":54,"_78":1202},{"_76":54,"_78":1201},{"_76":54,"_78":1200},{"_76":54,"_78":1199},{"_76":54,"_78":258},{"_76":54,"_78":1198},{"_76":54,"_78":1197},{"_76":54,"_78":258},{"_76":54,"_78":1196},{"_76":54,"_78":1195},{"_76":54,"_78":1194},{"_76":54,"_78":1193},{"_76":54,"_78":1192},{"_76":54,"_78":1191},{"_76":54,"_78":1190},"SOFTWARE.","OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE","LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,","AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER","FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE","IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,","THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR","copies or substantial portions of the Software.","The above copyright notice and this permission notice shall be included in all","furnished to do so, subject to the following conditions:","copies of the Software, and to permit persons to whom the Software is","to use, copy, modify, merge, publish, distribute, sublicense, and/or sell","in the Software without restriction, including without limitation the rights","of this software and associated documentation files (the \"Software\"), to deal","Permission is hereby granted, free of charge, to any person obtaining a copy","Copyright GitHub, Inc.","MIT License","28a50fa2","id","01M3EAY0H03NDC9T4D7T9N71C6","project","number",189,"title","Add the gh-stack dev skill","description",{"_1247":1248,"_53":1249},"state","merged","base",{"_1210":18,"_1243":1246,"_1245":36},"head",{"_1210":18,"_1243":1244,"_1245":38},"mergeRevision","c0ec927a98b04e34871ed6c6bf527b4490dd5dde","implements",[],"addresses",[],"createdBy",{"_1239":1240},"createdAt","2026-09-26T07:47:32.000Z","updatedAt","2026-09-28T08:58:06.000Z","locked","fork","headAvailable",true,"actor",{"_52":1241,"_1208":1242},"user","import:github:57336517","branch","refs/pull/189/head","revision","refs/heads/main","format","markdown","Part of GitHub stack #190 (infrastructure).\n\nAdds the `gh-stack` agent skill to `.agents/skills/gh-stack/`, so coding agents working on Chopin can create and manage GitHub stacked pull requests with the [`gh stack`](https://github.com/github/gh-stack) CLI extension.\n\nThis is the second PR in an infrastructure stack, on top of #185 (Bun 1.4.2). The pluggable-harness work for #181 is a separate stack.\n\n- The skill is vendored verbatim from `github/gh-stack` at `2bd699a544a09cb5c45a013d03416e0894b0454e`: `SKILL.md` and `references/{commands,stack-design,troubleshooting}.md`, plus the upstream MIT `LICENSE`.\n- `dprint.json` excludes `.agents/skills/gh-stack/**`, so the files stay identical to upstream and a refresh is a plain copy. dprint would otherwise restyle two markdown emphasis markers.\n- Like `testing-pr-previews`, this is a development skill living directly in `.agents/skills/`. It is not a product skill under `skills/`.\n\nOne note for this repository: if your `origin` remote uses an SSH host alias (for example `workgit:githubnext/chopin`), `gh stack` can't infer the repository. Set `GH_REPO=githubnext/chopin` on the command.\n\nAssistant-model: Claude Opus 5.5\nAssistant-workflow: inline\nAssistant-verification: bun run ci passed: dprint, oxlint, tokens with the vendored skill excluded from formatting\nAssistant-verification: diff -r against upstream passed: skill files identical to github/gh-stack@2bd699a apart from the added LICENSE\nAssistant-verification: relative link check passed: every .md link in the skill resolves\nAssistant-verification: gh stack link passed: GH_REPO=githubnext/chopin gh stack link created stack #188 from #185-#187 with the workgit SSH alias remote\nUser-preference: Group related infrastructure PRs into their own GitHub stack, separate from feature stacks\nCo-authored-by: @lavaman131\n\n","lavaman131","documentNavigation","repo","githubnext/chopin","repoId","ownerId","org:89615882","site","nexthub","private","admin","settings","triage","starred","stars","watchers","watching","pinned","notify","views",[1389,1390,1391,1392,1393,1394,1395,1396,1397,1398,1399,1400,1401],"navigation",{"_1269":1270,"_1349":1350,"_1351":1352,"_1353":1354,"_1355":1356,"_1357":1358,"_76":1359},"sources",[],"meta",{"_1215":1344,"_1345":1346,"_1347":258,"_1259":22,"_1221":1339,"_1348":22,"_1264":56,"_1265":56},"branches",[1287,1288,1289,1290,1291,1292,1293,1294,1295,1296,1297,1298,1299,1300,1301,1302,1303,1304,1305,1306,1307,1308,1309,1310,30,1311,1312,1313,1314,1315,1316,1317,1318,1319,1320,1321,1322,1323,1324,1325,1326,1327,1328,1329,1330,1331,1332,1333,1334,1335,1336,1337,1338,1339,1340,1341,1342,1343],"tags",[1283,1284,1285,1286],"cloneUrl","https://git.nexthub.sh/githubnext/chopin.git","color-controls-slice-1","color-controls-slice-2","color-controls-slice-3","color-controls-slice-4","Krzysztof-Cieslak-patch-1","Krzysztof-Cieslak-patch-2","Maggie/app-preview-toolkit","Maggie/ci-playwright-install-timeout","Maggie/collaborative-visual-decision","Maggie/design-audit","Maggie/generic-visual-decision-runtime","Maggie/impeccable-chopin-metadata","Maggie/jev-chat-product","Maggie/jev-composed-assessment","Maggie/native-document-layouts","Maggie/openui-composition-product","Maggie/openui-composition-trial","Maggie/planner-visual-authoring","Maggie/planner-visual-requests","Maggie/visual-selection-eval","artifacts/pr-419-live-preview-20261009","automation/pr-maintenance-state","automation/use-effect/callout-disabled-picker-8cf9e49ba5c09471","automation/use-effect/collaboration-options-ref-4e3a5a08a879a5ae","automation/use-effect/room-workspace-effective-access-a57d40866c71bed0","chore/bun-1.4.2","color-controls","color-controls-plan","design-pr-assets","design/archived-decisions-badge","design/channel-route-remount","design/chat-decision-entry","design/conversation-analysis-markers","design/decision-evidence","design/settled-line-icon","dev/integration","diagram-step-controls","feat/liveapp-frontend-pilot","feat/local-experiments","feat/local-launcher-tracer","fix/autolink-mdx-crash","github-pills/2-pills","github-pills/3-hover-card","maggie/app-preview-toolkit","maggie/ci-playwright-install-timeout","maggie/collaborative-visual-decision","maggie/design-audit","maggie/generic-visual-decision-runtime","maggie/impeccable-chopin-metadata","maggie/jev-composed-assessment","maggie/native-document-layouts","maggie/openui-composition-product","maggie/openui-composition-trial","maggie/planner-visual-authoring","maggie/planner-visual-requests","maggie/visual-selection-eval","main","plain-text-fence-chrome","tokens/09-copy","wireframes/2-renderer","wireframes/3-planner","Let's compose rich plans together","owner","githubnext","section","empty","pins",[1373,1374,1375],"documents",{"_1368":1369,"_1370":1371},"code",{"_23":1365,"_1366":1367},"automations",{"_1362":1363,"_1364":-5},"delivery",{"_1360":56,"_1361":-5},"04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments",1000,"changes",13,"counts",{"_1372":1371},"total",11,"issue",{"_1208":1366,"_1377":1387,"_48":1366,"_1379":1388,"_1267":1238,"_1381":22,"_1382":1238,"_1383":1367},{"_1208":1384,"_1377":1385,"_48":1384,"_1379":1386,"_1267":1238,"_1381":22,"_1382":1238,"_1383":56},{"_1208":1376,"_1377":1378,"_48":1376,"_1379":1380,"_1267":1238,"_1381":22,"_1382":1238,"_1383":1371},"issues","name","Issues","filters",{},"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_1208":1366,"_1377":1387,"_48":1366,"_1379":1432,"_1267":1238,"_1381":22,"_1382":1238},{"_1208":1384,"_1377":1385,"_48":1384,"_1379":1431,"_1267":1238,"_1381":22,"_1382":1238},{"_1208":1376,"_1377":1378,"_48":1376,"_1379":1430,"_1267":1238,"_1381":22,"_1382":1238},{"_1208":1427,"_1377":1428,"_48":1427,"_1379":1429,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1424,"_1377":1425,"_48":1424,"_1379":1426,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1362,"_1377":1422,"_48":1355,"_1379":1423,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1364,"_1377":1419,"_48":1420,"_1379":1421,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1360,"_1377":1417,"_48":1360,"_1379":1418,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1413,"_1377":1414,"_48":1415,"_1379":1416,"_1267":22,"_1381":22,"_1382":1238},{"_1208":1351,"_1377":1411,"_48":1351,"_1379":1412,"_1267":22,"_1381":22,"_1382":22},{"_1208":1408,"_1377":1409,"_48":1408,"_1379":1410,"_1267":22,"_1381":22,"_1382":22},{"_1208":1405,"_1377":1406,"_48":1405,"_1379":1407,"_1267":22,"_1381":22,"_1382":22},{"_1208":1402,"_1377":1403,"_48":1402,"_1379":1404,"_1267":22,"_1381":22,"_1382":22},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups",[],"now",1794437972854,"sidebar","expanded"]