Scroll to navigation

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

NAME

gt-time-start - Start a stopwatch on an issue

SYNOPSIS

gt time start {<number> | <url>} [flags]

DESCRIPTION

Start a stopwatch on an issue or pull request, to log the time it runs with gt time stop. Gitea runs one stopwatch per user: starting one stops the one running on another issue and logs its time, which gt time start reports. gt time status shows the one that runs. The repository needs time tracking turned on.

ARGUMENTS

An issue can be supplied as argument in any of the following formats:
- by number, e.g. "123" or "#123"
- by URL, e.g. "https://gitea.com/OWNER/REPO/issues/123"
- by repository and number, e.g. "OWNER/REPO#123"
Several issues must be in one repository. Next to "OWNER/REPO#123" or a URL, "124" means
OWNER/REPO#124, unless gt targets another repository otherwise, such as the clone's, --repo
or GITEA_CLI_REPO: then the command fails, and the number must be qualified.

OPTIONS

--dry-run[=false] Show the write requests gt would send, without sending them

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

OPTIONS INHERITED FROM PARENT COMMANDS

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

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

$ gt time start 12
$ gt time stop 12

SEE ALSO

gt-time(1)

Nov 2026 gitea-cli