Output and scripting

Scripts should read JSON: the text output is meant for people and may change.

gt pr view 123 --json number,title,state
gt issue list --json number,title --jq '.[] | "\(.number)\t\(.title)"'

--json prints all fields or the ones you list; the JSON FIELDS section of a command’s --help names them. --jq filters the result without needing jq installed. Piped lists print as tab-separated values.

gt exits with 0 on success, 1 when a command fails, 2 on a usage error and 4 when authentication is missing or rejected; gt help exit-codes lists all codes.

gt api calls any API endpoint with gt’s login, and gt alias set defines shortcuts for commands you use often.