---
name: "gt-run-list"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-run-list"
---

# gt-run-list(1)

List workflow runs

## NAME

gt-run-list - List workflow runs

## SYNOPSIS

**gt run list \[flags\]**

## DESCRIPTION

List the workflow runs of a repository, newest first.

\--since and --until compare the time a run was created; gt scans up to 5000 runs to apply them.

### JSON FIELDS

```
actor, attempt, branch, commit, completed_at, conclusion, created_at, event,
id, run_number, started_at, status, title, updated_at, url, workflow,
workflow_path
```

## OPTIONS

**-u**, **--actor**=""\
 	Filter by the user who triggered the run (@me for yourself)

**-b**, **--branch**=""\
 	Filter by branch

**-c**, **--commit**=""\
 	Filter by the commit that triggered the run: its full SHA, or a revision of the local clone

**-e**, **--event**=""\
 	Filter by the event that triggered the run, such as push

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

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

**--page**=1\
 	Result page

**--since**=""\
 	Runs created at or after a date, RFC3339 timestamp, or duration ago (24h)

**-s**, **--status**=\[\]\
 	Filter by status or conclusion

**--until**=""\
 	Runs created at or before a date, RFC3339 timestamp, or duration ago

**-w**, **--workflow**=""\
 	Filter by workflow file or name

## 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)

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

## EXAMPLE

```
# list recent runs
$ gt run list
# list failed runs of the CI workflow on main
$ gt run list --workflow CI --branch main --status failure
# list the runs created in the last day as JSON
$ gt run list --since 24h --json id,status,conclusion,workflow
```

## SEE ALSO

**[gt-run(1)](/man/gt-run/1.md)**