GT-ISSUE-LIST(1)               gitea-cli Manual               GT-ISSUE-LIST(1)



NAME
       gt-issue-list - List issues in a repository



SYNOPSIS
       gt issue list [flags]



DESCRIPTION
       List the issues of a repository, newest first. Filters combine: an
       issue must match all of them.  Labels and milestones must exist in the
       repository.


   JSON FIELDS
       assignees, author, body, comments, created_at, due_date, id, kind, labels,
       milestone, number, ref, state, title, updated_at, url



OPTIONS
       -a, --assignee=""   Filter by assignee; @me for yourself


       -A, --author=""     Filter by author; @me for yourself


       -h, --help[=false]  help for list


       --kind="issues"     List issues, pull requests or both; the kind field
       of each reads issue or pull {issues|pulls|all}


       -l, --label=[]      Filter by label names; an issue must have all of
       them


       -L, --limit=30      Maximum number of results (1..1000)


       --mentions=""  Filter by mentioned user; @me for yourself


       -m, --milestone=[]  Filter by milestone titles or IDs, a number being
       an ID first


       --no-assignee[=false]    Only issues without an assignee


       --page=1  Result page


       -S, --search=""     Search issue titles and bodies


       --select[=false]    Pick an item from a filterable list, view it and
       choose what to do with it


       --since=""     Updated since a date, timestamp, or duration ago


       -s, --state="open"  Filter by state {open|closed|all}


       --until=""     Updated before a date, timestamp, or duration ago


       -w, --web[=false]   Open the issue list in the browser



OPTIONS INHERITED FROM PARENT COMMANDS
       --csv[=""]     Output CSV with the specified comma-separated fields, or
       all fields


       --cwd=""  Working directory for repository discovery


       --debug[=false]     Log the method, URL, status, and duration of each
       HTTP request to stderr


       --host=""      Gitea instance URL, including any base path


       --interactive[=false]    Allow prompts with machine output


       -q, --jq=""    Filter JSON output using a jq expression; implies --json


       --json[=""]    Output JSON with the specified comma-separated fields,
       or all fields


       --no-input[=false]  Disable prompts and implicit editor/browser
       interactions


       --remote=""    Git remote used for repository discovery


       -R, --repo=""  Select a repository as OWNER/REPO or URL


       --sudo=""      Perform API requests as this user (requires an
       administrator account)


       --template=""  Format JSON output using a Go template; implies --json
       (see gt help formatting)


       --user=""      Account name on the selected instance



EXAMPLE
       $ gt issue list --label bug --state all
       $ gt issue list --assignee @me --json number,title
       $ gt issue list --no-assignee --label bug
       # Issues and pull requests in a milestone, as tab-separated values
       $ gt issue list --kind all --milestone v1.0 | cut -f1,2
       # Pick an issue from a filterable list, then comment on it or close it
       $ gt issue list --select



SEE ALSO
       gt-issue(1)

gitea-cli                          Nov 2026                   GT-ISSUE-LIST(1)