gh issue adds hierarchy, type, and dependency workflows
Introduced 2026-06-10 · score 0.97
HOW TO USE IT
When managing issue types, hierarchy, or dependencies, use `gh` v2.94.0 or later in a supported repository; create or edit issues with the documented flags, then read structure with `gh issue view` or `gh issue list --json`.
gh issue create --title "<title>" --body "<body>" --type <type> --parent <parent-number> --blocked-by <issue-number>gh issue edit <issue-number> --type <type> --add-sub-issue <sub-issue-number> --add-blocking <issue-number>gh issue list --type <type> --json number,title,issueType,parent,subIssues,blockedBy,blockingWHY THIS HELPS
When organizing repository work or automating issue workflows, create and inspect issue types, parent and sub-issue relationships, and dependencies from the terminal.
REQUIREMENTS AND LIMITATIONS
- Version: v2.94.0
- Requires Install or upgrade to GitHub CLI v2.94.0.
- --title <string>: Supply the new issue title; otherwise prompted.
- --body <string>: Supply the new issue body; otherwise prompted.
- --type <name>: Set or filter by issue type name.
- --parent <number>: Create the issue as a sub-issue of the specified parent number or URL.
- --blocked-by <numbers>: Mark the new issue as blocked by the listed issue numbers or URLs.
- --add-sub-issue <number>: Add the specified issue as a sub-issue.
- --add-blocking <numbers>: Add issue numbers or URLs that this issue blocks.
- --json <fields>: Output selected comma-separated JSON fields.
- issueType: JSON field for issue type.
- parent: JSON field for parent issue.
- subIssues: JSON field for sub-issues.
- blockedBy: JSON field for issues blocking this issue.
- blocking: JSON field for issues this issue blocks.
- Prerequisite: Use GitHub CLI v2.94.0 or later. Issue types and sub-issues are available on GitHub.com and GHES 3.17+; issue relationships require GHES 3.19+.
- Prerequisite: Issue type support applies in organizations that have defined issue types.
- Hierarchy and dependency support is available in repositories where those features are available.
- Issue types are configured at the organization level; type support applies to issues in organizations that have defined them.
FIRST-PARTY EVIDENCE
- https://github.blog/changelog/2026-06-10-manage-sub-issues-types-and-dependencies-from-github-cli
- https://cli.github.com/manual/gh_issue_create
- https://github.com/cli/cli/releases/tag/v2.94.0
- https://cli.github.com/manual/gh_issue_list
- https://cli.github.com/manual/gh_issue_view
Check the installed version and the source before using it. Entry JSON