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



NAME
       gt-time-list - List tracked time



SYNOPSIS
       gt time list [flags]



DESCRIPTION
       List the time tracked in a repository, on one issue with --issue, or by
       yourself across repositories with --mine. On a terminal, the total of
       the listed time follows the table.


   JSON FIELDS
       created_at, id, issue_number, issue_title, issue_url, repository, seconds,
       user



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


       --issue=""     List the time on one issue or pull request, by number or
       URL


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


       --mine[=false]      List your time across repositories


       --page=1  Result page


       --since=""     Only time tracked since a date, timestamp, or duration
       ago


       --total[=false]     Print the total of the listed time also when piped


       --until=""     Only time tracked before a date, timestamp, or duration
       ago


       --username=""  List the time of one user; @me for yourself



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 time list
       $ gt time list --issue 12
       $ gt time list --mine --since 168h



SEE ALSO
       gt-time(1)

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