gt-status(1)

gt-status1

Show your work across repositories

Usage

gt status [flags]

Overview

Show the open issues and pull requests assigned to you, the reviews requested from you, and the open discussions that mention you. In a clone, it also lists the failing Actions runs of the clone's repository; -R scopes everything to one repository.

Json fields

assigned_issues, failing_runs, host, mentions, pull_requests, repository,
runs_included, runs_repository, user

Options

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

--limit=30
Maximum results in each section (1..100)

--runs[=true]
Include the failing Actions runs of the selected or discovered repository

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

Examples

$ gt status
$ gt status -R alice/project --runs=false

From gitea-cli 1.0.0-1 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.