ghcli / Issues / gh issue list

gh issue list

Triage issues from the command line

gh issue list prints the open issues for the current repository as a table. Filter by label, assignee, author, or milestone, run full search queries, and pipe --json output into your own triage scripts.

Quick answer

gh issue list

↧ Download snippet Full cheat sheet

Syntax

gh issue list [flags]

Examples

List open issues

gh issue list

Issues assigned to you

gh issue list --assignee @me

Open bugs only

gh issue list --label bug

Closed issues in a milestone

gh issue list --state closed --milestone v2.0

Search syntax

gh issue list --search "no:assignee sort:created-asc"

JSON for scripts

gh issue list --json number,title,labels --limit 200

Options & flags

Flag	What it does
-s, --state	Filter by state: open (default), closed, or all.
-l, --label	Filter by label (repeatable).
-a, --assignee	Filter by assignee. Use @me for yourself.
-A, --author	Filter by author.
-m, --milestone	Filter by milestone.
-S, --search	Search with GitHub issue search syntax.
-L, --limit	Maximum number of issues to fetch (default 30).
--json	Output specified fields as JSON.
-w, --web	Open the filtered list in the browser.

How to use gh issue list, step by step

Run gh issue list in the repository.
Filter with --label, --assignee @me, or --milestone.
Use --search for advanced queries like no:assignee.
Add --json to power dashboards and automation.

Common errors and fixes

no issues match your search in OWNER/REPO

Filters returned nothing. Add --state all or loosen the labels.

This repository has issues disabled

Issues are turned off for this repo, so there's nothing to list.

Related commands

Frequently asked questions

How do I list issues assigned to me?

Use gh issue list --assignee @me. The @me shortcut resolves to your authenticated account, so it works in any repository.

How do I filter issues by label?

Pass --label with the label name, repeatable for multiple: gh issue list --label bug --label priority.

Can gh issue list output JSON?

Yes. Use --json with fields like number, title, and labels, and refine with --jq to build triage scripts.