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



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)


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


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

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