{
  "slug": "gh-issue-create-edit-view-and-list-support-issue-types-sub-issues-and-relationsh-859cce174462",
  "title": "gh issue create, edit, view, and list support issue types, sub-issues, and relationships",
  "tools": [
    "gh"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-10T21:47:49.000Z",
  "announced_at": "2026-06-10T21:47:49.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When organizing repository work with GitHub CLI v2.94.0 or later, use `gh issue create` or `gh issue edit` to set types, parent/sub-issue links, and blocking relationships; use `view` or `list` to inspect them.",
    "examples": [
      "gh issue create --title \"<title>\" --body \"<body>\" --type Bug --parent <parent-number> --blocked-by <issue-number>",
      "gh issue edit <issue-number> --type Bug --parent <parent-number>",
      "gh issue edit <issue-number> --add-blocking <issue-number> && gh issue view <issue-number> --json issueType,parent,subIssues,blockedBy,blocking && gh issue list --type Bug --json issueType,parent,subIssues,blockedBy,blocking"
    ],
    "gotchas": [
      "Version: v2.94.0",
      "Availability: Issue types and sub-issues are available on GitHub.com and GHES 3.17+; relationships require GHES 3.19+.",
      "--type <name>: Set the issue type by name; on `gh issue list`, filter by issue type name.",
      "--parent <number|URL>: On create, make the new issue a sub-issue of the specified parent; on edit, set the parent issue.",
      "--add-sub-issue <number|URL>: Add the specified issue as a sub-issue.",
      "--blocked-by <numbers|URLs>: On create, mark the new issue as blocked by the specified issues.",
      "--add-blocking <number|URL>: Add a blocking relationship by issue number or URL.",
      "--json <fields>: Output selected JSON fields; `issueType`, `parent`, `subIssues`, `blockedBy`, and `blocking` are available on `view` and `list`.",
      "Prerequisite: Use GitHub CLI v2.94.0 or later for the release-described support.",
      "Prerequisite: Issue types and sub-issues are available on GitHub.com and GHES 3.17+; blocked-by/blocking relationships require GHES 3.19+.",
      "The stated GHES versions are required for the corresponding features."
    ]
  },
  "why_it_matters": "When organizing repository work from the CLI, set issue types, add sub-issues, or track blocking relationships.",
  "sources": [
    "https://github.com/cli/cli/releases/tag/v2.94.0",
    "https://cli.github.com/manual/gh_issue_create",
    "https://cli.github.com/manual/gh_issue_edit",
    "https://cli.github.com/manual/gh_issue_view"
  ],
  "rank": 0.98046,
  "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": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-4b976b4103a9dc0c-0:gate",
    "evidence_hash": "84d7aa8ca7ea52acf4defb7079e93c075b4800dedbb06ba31a7c0381933333de"
  },
  "review": {
    "draft_hash": "9526a3d84bc822c33b61884c238b7d96f349278efd1f0d6639b1f3940c50c704",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.75 (>= 0.6 needed)."
  }
}