[Design] RFC Advanced Issue Support

# Issues 2.0 CLI Design

Covering: Issue type support for gh CLI — create, edit, view, and list with --type flag, Sub-issues and parent relationship support — create, edit, and view with parent/sub-issue flags, Issue relationship support (blocked-by/blocking) — create, edit, and view, Combined Issues 2.0 scenarios — cross-feature interactions, full views, and regressions

## Table of Contents

### `gh issue create`
| Category | Scenario |
|---|---|
| Issue types | [With `--type` flag](#user-content-create-with-type) |
| Issue types | [Interactive mode — type picker](#user-content-create-interactive-type) |
| Errors | [Error: invalid type name](#user-content-create-error-invalid-type) |
| Sub-issues | [With `--parent` flag](#user-content-create-with-parent) |
| Sub-issues | [With `--parent` using cross-repo URL](#user-content-create-with-parent-url) |
| Relationships | [With `--blocked-by` and `--blocking`](#user-content-create-with-relationships) |
| Errors | [Error: GHES unsupported for relationships](#user-content-create-error-ghes-relationships) |
| Relationships | [Blocked by cross-repo issue (URL)](#user-content-create-with-cross-repo-blocking) |
| Combined | [All new flags together](#user-content-create-all-flags) |

### `gh issue edit`
| Category | Scenario |
|---|---|
| Issue types | [Set issue type](#user-content-edit-change-type) |
| Issue types | [Remove issue type](#user-content-edit-remove-type) |
| Errors | [Error: `--set-type` and `--remove-type` mutually exclusive](#user-content-edit-error-mutual-type) |
| Sub-issues | [Set parent issue](#user-content-edit-set-parent) |
| Sub-issues | [Remove parent](#user-content-edit-remove-parent) |
| Sub-issues | [Add sub-issues (comma-separated)](#user-content-edit-add-sub-issues) |
| Sub-issues | [Remove sub-issue](#user-content-edit-remove-sub-issue) |
| Errors | [Error: `--set-parent` and `--remove-parent` mutually exclusive](#user-content-edit-error-mutual-parent) |
| Relationships | [Add and remove `--blocked-by`](#user-content-edit-add-remove-blocked-by) |
| Relationships | [Add `--blocking` (comma-separated)](#user-content-edit-add-blocking) |
| Relationships | [Remove `--blocking`](#user-content-edit-remove-blocking) |
| Interactive | [Interactive metadata picker with new fields](#user-content-edit-interactive) |
| Combined | [Batch edit with `--set-type`](#user-content-edit-batch-type) |

### `gh issue view`
| Category | Scenario |
|---|---|
| TTY | [View with issue type](#user-content-view-with-type) |
| JSON | [Issue type (--json)](#user-content-view-json-issue-type) |
| TTY | [View with parent](#user-content-view-with-parent) |
| TTY | [View with cross-repo parent](#user-content-view-cross-repo-parent) |
| TTY | [Epic view — sub-issues with no parent](#user-content-view-epic) |
| JSON | [Parent and sub-issues (--json)](#user-content-view-json-parent-subissues) |
| TTY | [View with relationships](#user-content-view-with-relationships) |
| JSON | [Blocked-by and blocking (--json)](#user-content-view-json-relationships) |
| TTY | [Full view with all new fields populated](#user-content-view-full) |
| TTY | [Minimal view — unchanged from today](#user-content-view-minimal) |
| TTY | [Closed sub-issue with parent](#user-content-view-closed-sub-issue) |

### `gh issue list`
| Category | Scenario |
|---|---|
| Issue types | [Filter by issue type](#user-content-list-filter-by-type) |
| Issue types | [Combine `--type` with other filters](#user-content-list-type-with-filters) |


---

<a id="gh-issue-create"></a>

## `gh issue create`

<details><summary>What is changing</summary>

- **Issue types**: Create an issue with --type flag
- **Issue types**: Interactive issue creation with type picker (repo has issue types configured)
- **Errors**: Error when type name doesn't match any configured type in the repository
- **Sub-issues**: Create an issue as a sub-issue of a parent
- **Sub-issues**: Create a sub-issue with a cross-repo parent URL
- **Relationships**: Create an issue with --blocked-by and --blocking flags (comma-separated)
- **Errors**: Error when issue relationships are not supported on the target GHES version
- **Relationships**: Create an issue blocked by an issue in another repository (via URL)
- **Combined**: Create an issue with all new flags combined (type, parent, blocked-by, blocking)

</details>

<a id="create-with-type"></a>

#### With `--type` flag

*Input:*
```bash
$ gh issue create --title "Login broken" --type Bug --body "Can't log in"
```

*Output:*

![](https://github.com/user-attachments/assets/bfb8e237-a872-4a1f-b20b-a11327761518)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/127}}
' > create-with-type.ans
freeze create-with-type.ans --output create-with-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Created issue has issueType.name matching the --type argument
- Created issue has title matching the --title argument

</details>

---

<a id="create-interactive-type"></a>

#### Interactive mode — type picker

*Input:*
```bash
$ gh issue create
```

*Input:*
```bash
$ My new issue
```

*Output:*

![](https://github.com/user-attachments/assets/02898148-1c44-45db-bdad-c3175c3c2e39)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1;92m?\033[0m \033[1mIssue type\033[0m \033[0;36m[Use arrows to move, type to filter]\033[0m
\033[1;36m>\033[0m Bug
 Feature
 Task
' > create-interactive-type-step4.ans
freeze create-interactive-type-step4.ans --output create-interactive-type-step4.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

*Output:*

![](https://github.com/user-attachments/assets/c5515bb6-f78d-4227-bf68-18f8ac233c92)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/130}}
' > create-interactive-type-step6.ans
freeze create-interactive-type-step6.ans --output create-interactive-type-step6.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Created issue has issueType.name matching the --type argument

</details>

---

<a id="create-error-invalid-type"></a>

#### Error: invalid type name

*Input:*
```bash
$ gh issue create --title "Oops" --type Bugz
```

*Output:*

![](https://github.com/user-attachments/assets/87e5a31e-7ffb-4c7e-b9be-e04eb0c7f58e)

<details><summary>Source & reproduction</summary>

```bash
printf 'type "Bugz" not found; available types: {{type_list:Bug, Feature, Task}}
' > create-error-invalid-type.ans
freeze create-error-invalid-type.ans --output create-error-invalid-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="create-with-parent"></a>

#### With `--parent` flag

*Input:*
```bash
$ gh issue create --title "Implement parser" --body "Parse the thing" --parent 100
```

*Output:*

![](https://github.com/user-attachments/assets/76e6a540-4443-4676-9a42-51b70248d0c6)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/126}}
' > create-with-parent.ans
freeze create-with-parent.ans --output create-with-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue was created successfully
- Created issue has parent matching the --parent argument

</details>

---

<a id="create-with-parent-url"></a>

#### With `--parent` using cross-repo URL

*Input:*
```bash
$ gh issue create --title "Fix dependency" --parent https://github.com/cli/go-gh/issues/42
```

*Output:*

![](https://github.com/user-attachments/assets/36599f23-923e-4297-b62e-6be44369a492)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/129}}
' > create-with-parent-url.ans
freeze create-with-parent-url.ans --output create-with-parent-url.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue was created successfully
- Issue is a sub-issue of cli/go-gh#42 (cross-repo parent)

</details>

---

<a id="create-with-relationships"></a>

#### With `--blocked-by` and `--blocking`

*Input:*
```bash
$ gh issue create --title "Deploy v2" --blocked-by 200,201 --blocking 300
```

*Output:*

![](https://github.com/user-attachments/assets/e34dff21-7a58-4015-8d4e-1bec1c71da67)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/128}}
' > create-with-relationships.ans
freeze create-with-relationships.ans --output create-with-relationships.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue was created successfully
- Created issue has blockedBy list matching the --blocked-by arguments
- Created issue has blocking list matching the --blocking argument

</details>

---

<a id="create-error-ghes-relationships"></a>

#### Error: GHES unsupported for relationships

*Input:*
```bash
$ gh issue create --title "Test" --blocked-by 200
```

*Output:*

![](https://github.com/user-attachments/assets/6bdd92ff-a1ad-4318-a1ff-6c948e7ad6d1)

<details><summary>Source & reproduction</summary>

```bash
printf 'issue relationships are not supported on this GitHub Enterprise Server version
' > create-error-ghes-relationships.ans
freeze create-error-ghes-relationships.ans --output create-error-ghes-relationships.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="create-with-cross-repo-blocking"></a>

#### Blocked by cross-repo issue (URL)

*Input:*
```bash
$ gh issue create --title "Blocked by upstream" --blocked-by https://github.com/cli/go-gh/issues/42
```

*Output:*

![](https://github.com/user-attachments/assets/2184bca8-4aa5-4863-8b5e-d8e04fbfb8ce)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/131}}
' > create-with-cross-repo-blocking.ans
freeze create-with-cross-repo-blocking.ans --output create-with-cross-repo-blocking.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Created issue has blockedBy list including the cross-repo issue specified by URL

</details>

---

<a id="create-all-flags"></a>

#### All new flags together

*Input:*
```bash
$ gh issue create --title "Deploy v2" --type Task --parent 100 --blocked-by 200 --blocking 300
```

*Output:*

![](https://github.com/user-attachments/assets/2a524953-a131-4b3c-ba65-b6a6e2d02fcc)

<details><summary>Source & reproduction</summary>

```bash
printf 'Creating issue in {{repo:cli/cli}}

{{url:https://github.com/cli/cli/issues/130}}
' > create-all-flags.ans
freeze create-all-flags.ans --output create-all-flags.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Created issue has issueType, parent, blockedBy, and blocking fields matching the flag arguments
- Created issue has parent matching the --parent argument
- Created issue has blockedBy list matching the --blocked-by argument
- Created issue has blocking list matching the --blocking argument

</details>

---

<a id="gh-issue-edit"></a>

## `gh issue edit`

<details><summary>What is changing</summary>

- **Issue types**: Set issue type with --set-type flag
- **Issue types**: Remove issue type with --remove-type flag
- **Errors**: Error when both --set-type and --remove-type are specified
- **Sub-issues**: Set or replace the parent issue
- **Sub-issues**: Remove the parent issue
- **Sub-issues**: Add multiple sub-issues using comma-separated values
- **Sub-issues**: Remove a sub-issue
- **Errors**: Error when --set-parent and --remove-parent are used together
- **Relationships**: Add and remove blocked-by relationships in one call
- **Relationships**: Add blocking relationships with comma-separated values
- **Relationships**: Remove a blocking relationship
- **Interactive**: Interactive metadata picker showing all new fields (Type, Parent)
- **Combined**: Batch edit — set type on multiple issues in one call

</details>

<a id="edit-change-type"></a>

#### Set issue type

*Input:*
```bash
$ gh issue edit 123 --set-type Feature
```

*Output:*

![](https://github.com/user-attachments/assets/944688ef-5f49-424a-96ca-b8c0c71bc69d)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-change-type.ans
freeze edit-change-type.ans --output edit-change-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue issueType.name is updated to match the --set-type argument

</details>

---

<a id="edit-remove-type"></a>

#### Remove issue type

*Input:*
```bash
$ gh issue edit 123 --remove-type
```

*Output:*

![](https://github.com/user-attachments/assets/d828d401-b423-4e34-af0f-a883238d603d)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-remove-type.ans
freeze edit-remove-type.ans --output edit-remove-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue issueType is null after removal

</details>

---

<a id="edit-error-mutual-type"></a>

#### Error: `--set-type` and `--remove-type` mutually exclusive

*Input:*
```bash
$ gh issue edit 123 --set-type Bug --remove-type
```

*Output:*

![](https://github.com/user-attachments/assets/5ea51b7d-e3ee-40b9-96d0-5eae8b323027)

<details><summary>Source & reproduction</summary>

```bash
printf 'specify only one of --set-type or --remove-type
' > edit-error-mutual-type.ans
freeze edit-error-mutual-type.ans --output edit-error-mutual-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="edit-set-parent"></a>

#### Set parent issue

*Input:*
```bash
$ gh issue edit 123 --set-parent 100
```

*Output:*

![](https://github.com/user-attachments/assets/6ce4f599-eeb6-456e-b165-5d43c4f8b07b)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-set-parent.ans
freeze edit-set-parent.ans --output edit-set-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue parent field matches the --set-parent argument

</details>

---

<a id="edit-remove-parent"></a>

#### Remove parent

*Input:*
```bash
$ gh issue edit 123 --remove-parent
```

*Output:*

![](https://github.com/user-attachments/assets/eda18de7-d547-4fbc-8f31-b986370e7c34)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-remove-parent.ans
freeze edit-remove-parent.ans --output edit-remove-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue parent field is null

</details>

---

<a id="edit-add-sub-issues"></a>

#### Add sub-issues (comma-separated)

*Input:*
```bash
$ gh issue edit 100 --add-sub-issue 123,124,125
```

*Output:*

![](https://github.com/user-attachments/assets/d73055fb-b027-4e42-9933-2ead257f97cd)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/100}}
' > edit-add-sub-issues.ans
freeze edit-add-sub-issues.ans --output edit-add-sub-issues.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- All specified issues appear in the target issue's subIssues list

</details>

---

<a id="edit-remove-sub-issue"></a>

#### Remove sub-issue

*Input:*
```bash
$ gh issue edit 100 --remove-sub-issue 123
```

*Output:*

![](https://github.com/user-attachments/assets/06de093e-683e-4d17-8891-ebdffd6309b9)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/100}}
' > edit-remove-sub-issue.ans
freeze edit-remove-sub-issue.ans --output edit-remove-sub-issue.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Specified issue no longer appears in the target issue's subIssues list

</details>

---

<a id="edit-error-mutual-parent"></a>

#### Error: `--set-parent` and `--remove-parent` mutually exclusive

*Input:*
```bash
$ gh issue edit 123 --set-parent 100 --remove-parent
```

*Output:*

![](https://github.com/user-attachments/assets/f43a1fb9-8647-4675-83ff-e6d5fa87804b)

<details><summary>Source & reproduction</summary>

```bash
printf 'specify only one of --set-parent or --remove-parent
' > edit-error-mutual-parent.ans
freeze edit-error-mutual-parent.ans --output edit-error-mutual-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="edit-add-remove-blocked-by"></a>

#### Add and remove `--blocked-by`

*Input:*
```bash
$ gh issue edit 123 --add-blocked-by 200 --remove-blocked-by 201
```

*Output:*

![](https://github.com/user-attachments/assets/26c18f01-9f3e-419f-8c8f-734888c8b3fd)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-add-remove-blocked-by.ans
freeze edit-add-remove-blocked-by.ans --output edit-add-remove-blocked-by.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue blockedBy list includes the issues specified by --add-blocked-by
- Removed issue no longer appears in blockedBy list; added issue does appear

</details>

---

<a id="edit-add-blocking"></a>

#### Add `--blocking` (comma-separated)

*Input:*
```bash
$ gh issue edit 123 --add-blocking 300,301
```

*Output:*

![](https://github.com/user-attachments/assets/71284907-27e1-4784-8aa1-20533faac0c7)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-add-blocking.ans
freeze edit-add-blocking.ans --output edit-add-blocking.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue blocking list includes the issues specified by --add-blocking

</details>

---

<a id="edit-remove-blocking"></a>

#### Remove `--blocking`

*Input:*
```bash
$ gh issue edit 123 --remove-blocking 300
```

*Output:*

![](https://github.com/user-attachments/assets/1f7a20e8-1de7-4fe1-98d3-ad8d1b857ab9)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-remove-blocking.ans
freeze edit-remove-blocking.ans --output edit-remove-blocking.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Specified issue no longer appears in this issue's blocking list

</details>

---

<a id="edit-interactive"></a>

#### Interactive metadata picker with new fields

*Input:*
```bash
$ gh issue edit 123
```

*Input:*
```bash
$ {down}{down}{down}{down} {down}
```

*Output:*

![](https://github.com/user-attachments/assets/8c45cffd-e8a4-405f-a18e-93534804a79a)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1;92m?\033[0m \033[1mWhat would you like to edit?\033[0m \033[0;36m[Use arrows to move, space to select, type to filter]\033[0m
 [ ] Title
 [ ] Body
 [ ] Assignees
 [ ] Labels
 [ ] Type
 [ ] Parent
 [ ] Projects
 [ ] Milestone
' > edit-interactive-step2.ans
freeze edit-interactive-step2.ans --output edit-interactive-step2.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

*Output:*

![](https://github.com/user-attachments/assets/816aa091-1390-40de-88e8-0e6596ca4f83)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1;92m?\033[0m \033[1mType\033[0m \033[0;36m[Use arrows to move, type to filter]\033[0m
\033[1;36m>\033[0m Bug
 Feature
 Task
' > edit-interactive-step3.ans
freeze edit-interactive-step3.ans --output edit-interactive-step3.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

*Input:*
```bash
$ 100
```

*Output:*

![](https://github.com/user-attachments/assets/79956e4a-d398-4da0-ae99-0e1cd1baf18b)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1;92m?\033[0m \033[1mParent issue number or URL\033[0m
' > edit-interactive-step4.ans
freeze edit-interactive-step4.ans --output edit-interactive-step4.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

*Output:*

![](https://github.com/user-attachments/assets/199ba640-37fb-421f-9ac5-58eb758b392a)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
' > edit-interactive-step5.ans
freeze edit-interactive-step5.ans --output edit-interactive-step5.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- Issue issueType.name is updated to "Bug"
- Issue parent is set to cli/cli#100

</details>

---

<a id="edit-batch-type"></a>

#### Batch edit with `--set-type`

*Input:*
```bash
$ gh issue edit 123 124 125 --set-type Bug
```

*Output:*

![](https://github.com/user-attachments/assets/4060469e-af06-4efa-a284-6775752bc294)

<details><summary>Source & reproduction</summary>

```bash
printf '{{url:https://github.com/cli/cli/issues/123}}
{{url:https://github.com/cli/cli/issues/124}}
{{url:https://github.com/cli/cli/issues/125}}
' > edit-batch-type.ans
freeze edit-batch-type.ans --output edit-batch-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

<details><summary>Expected effects</summary>

- All specified issues have issueType.name matching the --set-type argument

</details>

---

<a id="gh-issue-view"></a>

## `gh issue view`

<details><summary>What is changing</summary>

- **TTY**: Issue view showing type on state line and in metadata
- **JSON**: JSON output for issueType field
- **TTY**: Issue view showing parent in metadata
- **TTY**: Issue view with a cross-repo parent showing full owner/repo prefix
- **TTY**: Epic issue view with multiple sub-issues and no parent
- **JSON**: JSON output for parent, subIssues, and subIssuesSummary fields
- **TTY**: Issue view showing blocked-by and blocking metadata
- **JSON**: JSON output for blockedBy and blocking fields
- **TTY**: Issue view with ALL new fields populated (type, parent, blocked-by, blocking, sub-issues)
- **TTY**: Issue view with no new fields set — proves no regression from today's output
- **TTY**: Closed sub-issue view — parent shown, no sub-issues section

</details>

<a id="view-with-type"></a>

#### View with issue type

*Input:*
```bash
$ gh issue view 123
```

*Output:*

![](https://github.com/user-attachments/assets/b5de8cd0-37b4-45bc-809b-48de99b8f517)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Login broken}}\033[0m {{repo_ref:cli/cli#123}}
\033[0;90m{{issue_type:Bug}}\033[0m · \033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 2 hours ago}} · {{count:0}} comments
\033[1mLabels:\033[0m {{labels:bug}}
\033[1mType:\033[0m {{issue_type:Bug}}

 \033[38;5;252m{{body_text:Something is broken when users try to log in.}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/123}}\033[0m
' > view-with-type.ans
freeze view-with-type.ans --output view-with-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-json-issue-type"></a>

#### Issue type (--json)

*Input:*
```bash
$ gh issue view 123 --json issueType
```

*Output:*

![](https://github.com/user-attachments/assets/1848dd21-96bd-4889-8204-4b94d43d5f9c)

<details><summary>Source & reproduction</summary>

```bash
printf '{
 "issueType": {
 "id": "{{title:IT_kwDOABCD12}}",
 "name": "{{issue_type:Bug}}",
 "description": "{{title:Something isn'\''t working}}",
 "color": "{{title:d73a4a}}"
 }
}
' > view-json-issue-type.ans
freeze view-json-issue-type.ans --output view-json-issue-type.png --language json --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-with-parent"></a>

#### View with parent

*Input:*
```bash
$ gh issue view 123
```

*Output:*

![](https://github.com/user-attachments/assets/9c2de735-3003-4351-bba7-151ddbedb4c9)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Implement OAuth flow}}\033[0m {{repo_ref:cli/cli#123}}
\033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 2 hours ago}} · {{count:2}} comments
\033[1mParent:\033[0m \033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#100}} {{title:Epic: Authentication overhaul}}

 \033[38;5;252m{{body_text:Implementing the OAuth flow as described in the parent issue.}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/123}}\033[0m
' > view-with-parent.ans
freeze view-with-parent.ans --output view-with-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-cross-repo-parent"></a>

#### View with cross-repo parent

*Input:*
```bash
$ gh issue view 129
```

*Output:*

![](https://github.com/user-attachments/assets/4d085afb-502c-4a7d-9d8f-47169b2e671e)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Fix go-gh dependency}}\033[0m {{repo_ref:cli/cli#129}}
\033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 1 hour ago}} · {{count:0}} comments
\033[1mParent:\033[0m \033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/go-gh#42}} {{title:Refactor auth module}}

 \033[38;5;252m{{body_text:The }}\033[38;5;203;48;5;236m{{code:go-gh}}\033[0m\033[38;5;252m{{body_text: auth module changed its API in v2. We need}}\033[0m
 \033[38;5;252m{{body_text:to update our usage to match.}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/129}}\033[0m
' > view-cross-repo-parent.ans
freeze view-cross-repo-parent.ans --output view-cross-repo-parent.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-epic"></a>

#### Epic view — sub-issues with no parent

*Input:*
```bash
$ gh issue view 100
```

*Output:*

![](https://github.com/user-attachments/assets/d33467be-811b-4929-b61b-217b01e46a38)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Authentication overhaul}}\033[0m {{repo_ref:cli/cli#100}}
\033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 1 week ago}} · {{count:12}} comments
\033[1mAssignees:\033[0m {{assignees:user1, user2}}
\033[1mLabels:\033[0m {{labels:epic, auth}}
\033[1mType:\033[0m {{issue_type:Task}}
\033[1mProjects:\033[0m {{project:Auth Overhaul (In Progress)}}
\033[1mMilestone:\033[0m {{milestone:v2.0}}

 \033[38;5;252m{{body_text:This epic tracks the full authentication overhaul for v2.0.}}\033[0m
 \033[38;5;252m{{body_text:All sub-issues must be completed before release.}}\033[0m

\033[1mSub-issues\033[0m · {{count:3}}/{{count:5}} ({{percent:60%%}})
\033[0;35m{{state:Closed}}\033[0m {{issue_ref:cli/cli#101}} {{title:Design auth module API}}
\033[0;35m{{state:Closed}}\033[0m {{issue_ref:cli/cli#102}} {{title:Implement OAuth token exchange}}
\033[0;35m{{state:Closed}}\033[0m {{issue_ref:cli/cli#103}} {{title:Add SSO support}}
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#104}} {{title:Token refresh logic}}
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#105}} {{title:Migration guide}}

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/100}}\033[0m
' > view-epic.ans
freeze view-epic.ans --output view-epic.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-json-parent-subissues"></a>

#### Parent and sub-issues (--json)

*Input:*
```bash
$ gh issue view 123 --json parent,subIssues,subIssuesSummary
```

*Output:*

![](https://github.com/user-attachments/assets/38cb1675-99bd-4d18-90a5-b1d476567aad)

<details><summary>Source & reproduction</summary>

```bash
printf '{
 "parent": {
 "number": {{number:100}},
 "title": "{{title:Epic: Authentication overhaul}}",
 "url": "{{url:https://github.com/cli/cli/issues/100}}",
 "state": "{{state:OPEN}}"
 },
 "subIssues": [
 {
 "number": {{number:124}},
 "title": "{{title:Implement OAuth flow}}",
 "url": "{{url:https://github.com/cli/cli/issues/124}}",
 "state": "{{state:CLOSED}}"
 },
 {
 "number": {{number:125}},
 "title": "{{title:Add token refresh}}",
 "url": "{{url:https://github.com/cli/cli/issues/125}}",
 "state": "{{state:OPEN}}"
 }
 ],
 "subIssuesSummary": {
 "total": {{count:2}},
 "completed": {{count:1}},
 "percentCompleted": {{count:50}}.0
 }
}
' > view-json-parent-subissues.ans
freeze view-json-parent-subissues.ans --output view-json-parent-subissues.png --language json --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-with-relationships"></a>

#### View with relationships

*Input:*
```bash
$ gh issue view 123
```

*Output:*

![](https://github.com/user-attachments/assets/5c2d7d46-b0b3-40b5-9151-f053158695cd)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Deploy v2}}\033[0m {{repo_ref:cli/cli#123}}
\033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 1 hour ago}} · {{count:0}} comments
\033[1mBlocked by:\033[0m
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#200}} {{title:API rate limiting}}
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#201}} {{title:Fix auth tokens}}
\033[1mBlocking:\033[0m
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#300}} {{title:Release v2.0}}

 \033[38;5;252m{{body_text:Deploy the v2.0 release once all blockers are resolved.}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/123}}\033[0m
' > view-with-relationships.ans
freeze view-with-relationships.ans --output view-with-relationships.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-json-relationships"></a>

#### Blocked-by and blocking (--json)

*Input:*
```bash
$ gh issue view 123 --json blockedBy,blocking
```

*Output:*

![](https://github.com/user-attachments/assets/1d75b396-f009-40d4-8890-4f0a85a2de9e)

<details><summary>Source & reproduction</summary>

```bash
printf '{
 "blockedBy": [
 {
 "number": {{number:200}},
 "title": "{{title:API rate limiting}}",
 "url": "{{url:https://github.com/cli/cli/issues/200}}",
 "state": "{{state:OPEN}}"
 },
 {
 "number": {{number:201}},
 "title": "{{title:Fix auth tokens}}",
 "url": "{{url:https://github.com/cli/cli/issues/201}}",
 "state": "{{state:OPEN}}"
 }
 ],
 "blocking": [
 {
 "number": {{number:300}},
 "title": "{{title:Release v2.0}}",
 "url": "{{url:https://github.com/cli/cli/issues/300}}",
 "state": "{{state:OPEN}}"
 }
 ]
}
' > view-json-relationships.ans
freeze view-json-relationships.ans --output view-json-relationships.png --language json --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-full"></a>

#### Full view with all new fields populated

*Input:*
```bash
$ gh issue view 123
```

*Output:*

![](https://github.com/user-attachments/assets/8d28255a-b8d3-40b9-9980-d105ea28ef82)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Implement OAuth flow}}\033[0m {{repo_ref:cli/cli#123}}
\033[0;90m{{issue_type:Bug}}\033[0m · \033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 2 hours ago}} · {{count:5}} comments
\033[1mAssignees:\033[0m {{assignees:user1, user2}}
\033[1mLabels:\033[0m {{labels:enhancement, auth}}
\033[1mType:\033[0m {{issue_type:Bug}}
\033[1mParent:\033[0m \033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#100}} {{title:Epic: Authentication overhaul}}
\033[1mBlocked by:\033[0m
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#200}} {{title:API rate limiting}}
\033[1mBlocking:\033[0m
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#300}} {{title:Release v2.0}}
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#301}} {{title:Update docs}}
\033[1mProjects:\033[0m {{project:Auth Overhaul (In Progress)}}
\033[1mMilestone:\033[0m {{milestone:v2.0}}

 \033[38;5;252m{{body_text:The OAuth flow is currently broken when users attempt to log in}}\033[0m
 \033[38;5;252m{{body_text:with SSO-enabled organizations. This needs to be fixed before}}\033[0m
 \033[38;5;252m{{body_text:the v2.0 release.}}\033[0m

 \033[38;5;39;1m## {{heading:Steps to reproduce}}\033[0m

 \033[38;5;252m1. Log in with an SSO-enabled org\033[0m
 \033[38;5;252m2. Attempt to authorize the OAuth app\033[0m
 \033[38;5;252m3. Observe the \033[38;5;203;48;5;236m{{code:403}}\033[0m\033[38;5;252m error\033[0m

\033[1mSub-issues\033[0m · {{count:1}}/{{count:2}} ({{percent:50%%}})
\033[0;35m{{state:Closed}}\033[0m {{issue_ref:cli/cli#124}} {{title:Implement OAuth flow}}
\033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#125}} {{title:Add token refresh}}

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/123}}\033[0m
' > view-full.ans
freeze view-full.ans --output view-full.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-minimal"></a>

#### Minimal view — unchanged from today

*Input:*
```bash
$ gh issue view 456
```

*Output:*

![](https://github.com/user-attachments/assets/2dd7028a-7c54-4620-b91b-593b000e481c)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Simple bug report}}\033[0m {{repo_ref:cli/cli#456}}
\033[0;32m{{state:Open}}\033[0m · {{author:user1}} opened {{time_ago:about 1 day ago}} · {{count:0}} comments
\033[1mLabels:\033[0m {{labels:bug}}

 \033[38;5;252m{{body_text:Something is broken when running }}\033[38;5;203;48;5;236m{{code:gh issue list}}\033[0m\033[38;5;252m{{body_text: with the}}\033[0m
 \033[38;5;203;48;5;236m{{code:--assignee}}\033[0m\033[38;5;252m{{body_text: flag. It returns an empty list even when there}}\033[0m
 \033[38;5;252m{{body_text:are assigned issues.}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/456}}\033[0m
' > view-minimal.ans
freeze view-minimal.ans --output view-minimal.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="view-closed-sub-issue"></a>

#### Closed sub-issue with parent

*Input:*
```bash
$ gh issue view 124
```

*Output:*

![](https://github.com/user-attachments/assets/6ad858ac-e4b0-42db-a117-be350d76a55c)

<details><summary>Source & reproduction</summary>

```bash
printf '\033[1m{{title:Implement OAuth flow}}\033[0m {{repo_ref:cli/cli#124}}
\033[0;35m{{state:Closed}}\033[0m · {{author:user1}} opened {{time_ago:about 3 days ago}} · {{count:2}} comments
\033[1mParent:\033[0m \033[0;32m{{state:Open}}\033[0m {{issue_ref:cli/cli#100}} {{title:Epic: Authentication overhaul}}

 \033[38;5;252m{{body_text:Implemented the OAuth flow as described in the parent issue.}}\033[0m
 \033[38;5;252m{{body_text:See cli/cli#100 for the full design.}}\033[0m

 \033[38;5;39;1m## {{heading:Changes}}\033[0m

 \033[38;5;252m{{body_text:• Added OAuth token exchange in }}\033[38;5;203;48;5;236m{{code:pkg/auth/oauth.go}}\033[0m
 \033[38;5;252m{{body_text:• Updated login command to use new flow}}\033[0m

\033[0;90mView this issue on GitHub: {{url:https://github.com/cli/cli/issues/124}}\033[0m
' > view-closed-sub-issue.ans
freeze view-closed-sub-issue.ans --output view-closed-sub-issue.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="gh-issue-list"></a>

## `gh issue list`

<details><summary>What is changing</summary>

- **Issue types**: Filter issue list by type
- **Issue types**: Combine --type with --state and --label filters

</details>

<a id="list-filter-by-type"></a>

#### Filter by issue type

*Input:*
```bash
$ gh issue list --type Bug
```

*Output:*

![](https://github.com/user-attachments/assets/f5aafe1b-950a-4240-843d-435e8f0a328d)

<details><summary>Source & reproduction</summary>

```bash
printf 'Showing {{count:1}} of {{count:15}} issues in {{repo:cli/cli}}

\033[0;32m#{{number:123}}\033[0m {{title:Implement OAuth flow}} \033[0;90m{{labels:auth, enhancement}}\033[0m \033[0;90m{{time_ago:about 2 hours ago}}\033[0m
' > list-filter-by-type.ans
freeze list-filter-by-type.ans --output list-filter-by-type.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

<a id="list-type-with-filters"></a>

#### Combine `--type` with other filters

*Input:*
```bash
$ gh issue list --type Bug --state closed --label p1
```

*Output:*

![](https://github.com/user-attachments/assets/83aba1d0-522e-43d4-8060-297fce8f0b04)

<details><summary>Source & reproduction</summary>

```bash
printf 'Showing {{count:2}} of {{count:8}} issues in {{repo:cli/cli}}

\033[0;35m#{{number:89}}\033[0m {{title:Login crash on Safari}} \033[0;90m{{labels:p1, bug}}\033[0m \033[0;90m{{time_ago:about 1 week ago}}\033[0m
\033[0;35m#{{number:67}}\033[0m {{title:Memory leak in auth}} \033[0;90m{{labels:p1, bug}}\033[0m \033[0;90m{{time_ago:about 2 weeks ago}}\033[0m
' > list-type-with-filters.ans
freeze list-type-with-filters.ans --output list-type-with-filters.png --language ansi --font.family 'JetBrains Mono,SF Mono,Menlo,monospace' --font.size 12 --line-height 1.4 --window --padding '20,40,20,20' --background '#2b3037' --margin 20 --shadow.blur 6 --border.radius 8 --width 1360
```

</details>

---

Category	Scenario
Issue types	With `--type` flag
Issue types	Interactive mode — type picker
Errors	Error: invalid type name
Sub-issues	With `--parent` flag
Sub-issues	With `--parent` using cross-repo URL
Relationships	With `--blocked-by` and `--blocking`
Errors	Error: GHES unsupported for relationships
Relationships	Blocked by cross-repo issue (URL)
Combined	All new flags together

Category	Scenario
Issue types	Set issue type
Issue types	Remove issue type
Errors	Error: `--set-type` and `--remove-type` mutually exclusive
Sub-issues	Set parent issue
Sub-issues	Remove parent
Sub-issues	Add sub-issues (comma-separated)
Sub-issues	Remove sub-issue
Errors	Error: `--set-parent` and `--remove-parent` mutually exclusive
Relationships	Add and remove `--blocked-by`
Relationships	Add `--blocking` (comma-separated)
Relationships	Remove `--blocking`
Interactive	Interactive metadata picker with new fields
Combined	Batch edit with `--set-type`

Category	Scenario
TTY	View with issue type
JSON	Issue type (--json)
TTY	View with parent
TTY	View with cross-repo parent
TTY	Epic view — sub-issues with no parent
JSON	Parent and sub-issues (--json)
TTY	View with relationships
JSON	Blocked-by and blocking (--json)
TTY	Full view with all new fields populated
TTY	Minimal view — unchanged from today
TTY	Closed sub-issue with parent

Category	Scenario
Issue types	Filter by issue type
Issue types	Combine `--type` with other filters

[Design] RFC Advanced Issue Support #13120

Description

Issues 2.0 CLI Design

Table of Contents

gh issue create

gh issue edit

gh issue view

gh issue list

gh issue create

With --type flag

Interactive mode — type picker

Error: invalid type name

With --parent flag

With --parent using cross-repo URL

With --blocked-by and --blocking

Error: GHES unsupported for relationships

Blocked by cross-repo issue (URL)

All new flags together

gh issue edit

Set issue type

Remove issue type

Error: --set-type and --remove-type mutually exclusive

Set parent issue

Remove parent

Add sub-issues (comma-separated)

Remove sub-issue

Error: --set-parent and --remove-parent mutually exclusive

Add and remove --blocked-by

Add --blocking (comma-separated)

Remove --blocking

Interactive metadata picker with new fields

Batch edit with --set-type

gh issue view

View with issue type

Issue type (--json)

View with parent

View with cross-repo parent

Epic view — sub-issues with no parent

Parent and sub-issues (--json)

View with relationships

Blocked-by and blocking (--json)

Full view with all new fields populated

Minimal view — unchanged from today

Closed sub-issue with parent

gh issue list

Filter by issue type

Combine --type with other filters

Metadata

Metadata

Assignees

Labels

Type

Fields

Projects

Milestone

Relationships

Development

Issue actions

`gh issue create`

`gh issue edit`

`gh issue view`

`gh issue list`

`gh issue create`

With `--type` flag

With `--parent` flag

With `--parent` using cross-repo URL

With `--blocked-by` and `--blocking`

`gh issue edit`

Error: `--set-type` and `--remove-type` mutually exclusive

Error: `--set-parent` and `--remove-parent` mutually exclusive

Add and remove `--blocked-by`

Add `--blocking` (comma-separated)

Remove `--blocking`

Batch edit with `--set-type`

`gh issue view`

`gh issue list`

Combine `--type` with other filters