.nh
.TH "GH-AGENT-TASK-LIST" "1" "Sep 2026" "" "GitHub CLI manual"

.SH NAME
gh-agent-task-list - List agent tasks (preview)


.SH SYNOPSIS
\fBgh agent-task list [flags]\fR


.SH OPTIONS
.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
Filter JSON output using a jq expression

.TP
\fB--json\fR \fB<fields>\fR
Output JSON with the specified fields

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 30)\fR
Maximum number of agent tasks to fetch

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
Format JSON output using a Go template; see "gh help formatting"

.TP
\fB-w\fR, \fB--web\fR
Open agent tasks in the browser


.SH JSON FIELDS
\fBcompletedAt\fR, \fBcreatedAt\fR, \fBid\fR, \fBname\fR, \fBpullRequestNumber\fR, \fBpullRequestState\fR, \fBpullRequestTitle\fR, \fBpullRequestUrl\fR, \fBrepository\fR, \fBstate\fR, \fBupdatedAt\fR, \fBuser\fR


.SH EXIT CODES
0: Successful execution

.PP
1: Error

.PP
2: Command canceled

.PP
4: Authentication required

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


.SH SEE ALSO
\fBgh-agent-task(1)\fR