GT-RUNNER(1)                   gitea-cli Manual                   GT-RUNNER(1)



NAME
       gt-runner - Manage Actions runners



SYNOPSIS
       gt runner [flags]



DESCRIPTION
       Manage the Actions runners that run workflow jobs: list them, see what
       they are doing, stop them from taking jobs, remove them, and print the
       token that registers new ones.


       Runners belong to a repository, to an organization with --org, to your
       account with --account, or to the whole instance with --global
       (administrators). Without these flags, gt uses the repository of the
       working directory or --repo. A list shows only the runners of its
       scope, not the organization and instance runners that also take a
       repository's jobs; with --global it shows every runner.



OPTIONS
       --account[=false]   Manage the runners of your account


       --global[=false]    Manage the runners of the instance (administrators)


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


       --org=""  Manage the runners of an organization



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



SEE ALSO
       gt(1), gt-runner-delete(1), gt-runner-disable(1), gt-runner-enable(1),
       gt-runner-list(1), gt-runner-token(1), gt-runner-view(1)

gitea-cli                          Nov 2026                       GT-RUNNER(1)