GH-ISSUE(1) GitHub CLI manual GH-ISSUE(1)

# [NAME](#NAME)

gh-issue - Manage issues

# [SYNOPSIS](#SYNOPSIS)

**gh issue <command> \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Work with GitHub issues.

# [GENERAL COMMANDS](#GENERAL_COMMANDS)

[**gh-issue-create(1)**](#gh_issue_create%281%29)

Create a new issue

[**gh-issue-list(1)**](#gh_issue_list%281%29)

List issues in a repository

[**gh-issue-status(1)**](#gh_issue_status%281%29)

Show status of relevant issues

# [TARGETED COMMANDS](#TARGETED_COMMANDS)

[**gh-issue-close(1)**](#gh_issue_close%281%29)

Close issue

[**gh-issue-comment(1)**](#gh_issue_comment%281%29)

Add a comment to an issue

[**gh-issue-delete(1)**](#gh_issue_delete%281%29)

Delete issue

[**gh-issue-develop(1)**](#gh_issue_develop%281%29)

Manage linked branches for an issue

[**gh-issue-edit(1)**](#gh_issue_edit%281%29)

Edit issues

[**gh-issue-lock(1)**](#gh_issue_lock%281%29)

Lock issue conversation

[**gh-issue-pin(1)**](#gh_issue_pin%281%29)

Pin an issue

[**gh-issue-reopen(1)**](#gh_issue_reopen%281%29)

Reopen issue

[**gh-issue-transfer(1)**](#gh_issue_transfer%281%29)

Transfer issue to another repository

[**gh-issue-unlock(1)**](#gh_issue_unlock%281%29)

Unlock issue conversation

[**gh-issue-unpin(1)**](#gh_issue_unpin%281%29)

Unpin an issue

[**gh-issue-view(1)**](#gh_issue_view%281%29)

View an issue

# [OPTIONS](#OPTIONS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# [EXAMPLE](#EXAMPLE)

```
$ gh issue list
$ gh issue create --label bug
$ gh issue view 123 --web
```

# [SEE ALSO](#SEE_ALSO)

[**gh(1)**](/man/os/gh/gh.1)

Oct 2026

---

Document: gh-issue(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli