{
  "slug": "gh-stack-checkout-resolves-active-remote-stacks-039ba6fea416",
  "title": "gh stack checkout resolves active remote stacks",
  "tools": [
    "gh-stack"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-02T15:44:29.000Z",
  "announced_at": "2026-09-02T15:44:29.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "If the current branch or requested branch is not tracked locally but belongs to an active remote stack, run `gh stack checkout` or `gh stack checkout <branch>` and accept the prompt to check it out. The command imports the matching stack through the PR checkout flow; fully merged stacks are omitted. ([v0.1.1 release](https://github.com/github/gh-stack/releases/tag/v0.1.1))",
    "examples": [
      "gh stack checkout",
      "gh stack checkout <branch>"
    ],
    "gotchas": [
      "Version: v0.1.1",
      "[<branch>]: Optional branch name to check out; when supplied and not tracked locally, the command searches remote stacks for a match. With no argument, it checks whether the current branch belongs to an active remote stack. ([gh-stack README](https://github.com/github/gh-stack/blob/v0.1.1/README.md))",
      "Prerequisite: Install the GitHub CLI extension with `gh extension install github/gh-stack`. ([v0.1.1 release](https://github.com/github/gh-stack/releases/tag/v0.1.1))",
      "Prerequisite: The command’s no-argument remote detection is offered in an interactive terminal. ([gh-stack README](https://github.com/github/gh-stack/blob/v0.1.1/README.md))",
      "Resolution is best-effort: network failures, no or multiple matches, or a declined prompt fall through to existing behavior.",
      "Fully merged stacks are ignored."
    ]
  },
  "why_it_matters": "Check out a stack when the current branch or a requested branch belongs to an active GitHub stack but is not in a local stack or tracked locally.",
  "before": "For a branch not tracked locally or not part of a local stack, use the existing checkout behavior if remote resolution does not offer a match.",
  "sources": [
    "https://github.com/github/gh-stack/releases/tag/v0.1.1",
    "https://github.com/github/gh-stack/blob/v0.1.1/README.md"
  ],
  "rank": 0.96025,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "augsep-20261008",
    "verdict_id": "augsep-20261008:augsep-20261008-9e98190cdbf09119-1:gate",
    "evidence_hash": "e3d3c6aa60cd3379b520ba512c48ac99b28604843da8ff4072324dc39337ff1d"
  },
  "review": {
    "draft_hash": "14ec561a4bbe931dbef06eb6dde2b4b541648664deb4ec849361b5565c2558d4",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "augsep-20261008:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.75 (>= 0.6 needed)."
  }
}