1---2name: gh-issue-list3description: List and filter GitHub issues using gh CLI with various filters like state, author, labels, milestone, and search queries.4---56# GitHub Issue List78## When to use910- The user asks to list issues in a repository.11- Finding issues by author, label, milestone, or state.12- Reviewing issue backlog or triaging.1314## Inputs to confirm1516- Filter criteria: state (open/closed/all), author, assignee, labels, milestone.17- Search query if advanced filtering needed.18- Target repo if not current (`--repo OWNER/REPO`).19- Output format (table, JSON, web).2021## Workflow22231. Verify auth:24 ```bash25 gh --version26 gh auth status27 ```282. List issues with filters:29 ```bash30 gh issue list31 gh issue list --state all --limit 5032 gh issue list --author "@me"33 gh issue list --label "bug" --label "priority"34 gh issue list --assignee "@me" --state open35 gh issue list --milestone "v2.0"36 ```373. Use search syntax for advanced queries:38 ```bash39 gh issue list --search "no:assignee sort:created-asc"40 gh issue list --search "is:open label:bug -label:wontfix"41 ```424. Get JSON output for scripting:43 ```bash44 gh issue list --json number,title,state,labels --jq '.[] | "\(.number): \(.title)"'45 ```4647## Examples4849```bash50# List your assigned issues51gh issue list --assignee "@me"5253# Find unassigned bugs54gh issue list --label "bug" --search "no:assignee"5556# List issues in a milestone57gh issue list --milestone "Release 1.0"5859# Get issues as JSON60gh issue list --json number,title,state,assignees6162# Open issue list in browser63gh issue list --web64```6566## Flags reference6768| Flag | Description |69| ----------------- | ----------------------------------------- |70| `-s, --state` | Filter: open, closed, all (default: open) |71| `-A, --author` | Filter by author |72| `-a, --assignee` | Filter by assignee |73| `-l, --label` | Filter by label (repeatable) |74| `-m, --milestone` | Filter by milestone name or number |75| `--mention` | Filter by mentioned user |76| `-S, --search` | Search with GitHub query syntax |77| `-L, --limit` | Max items to fetch (default 30) |78| `--json` | Output specific fields as JSON |79| `-w, --web` | Open list in browser |8081## References8283- GitHub CLI manual: https://cli.github.com/manual/84- Search syntax: https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests85- `gh issue list --help`