raucao
8b5c216563
Cover the 1.0.0 command surface and stability guarantees: - New reference files: projects.md, runners.md, extensions.md - New commands: browse, project, runner, extension, upgrade, pr backport, pr update-branch, pr list --local, pr merge --method manually-merged, issue move, issue/pr comment attachment, webhook test - Global --csv output; exit codes 5 (run watch failed) and 6 (--expect-head) - Interactive edit forms for pr/label/release edit - Fix fork flag (--add-remote), clone flag (--upstream-remote-name), and org member subcommands (add -> conceal/publicize) - tea is archived; gt is the official successor; migration guide linked - Semver: 1.x keeps commands/flags/JSON fields/exit codes stable - Bump metadata/README to gt 1.0.0
2.2 KiB
Projects (gt project)
Issue/PR project boards of a repository, an organization or your account.
gt <cmd> --help is authoritative. Global/repository-selection flags are in
SKILL.md.
gt project <command>
close create delete edit list reopen view
project list aliases project ls; project create aliases project new;
project delete aliases project rm.
Scope: the selected repository (default), an organization with
--org ORG, or your account with --account.
Project argument: a title, such as Roadmap, or an ID. A number is an ID
first, then a title; --by-name matches it as a title only.
JSON fields: card_type, closed_issues, created_at, description, id, open_issues, state, title, type, updated_at, url.
create
create [<title>] [-t title] [-d description] [--card-type {text_only|images_and_text}] [--template {none|basic_kanban|bug_triage}] [-f|--force] — without a title on
a terminal, a prompt asks for it. --template creates the board's columns. A
project with the same title, ignoring case, is refused unless --force updates
it (titles address projects). Prints the project URL.
gt project create Roadmap --template basic_kanban
gt project create --title "Bug triage" --org acme --template bug_triage -d "Incoming bugs"
gt project create Roadmap --description "Planned work" --force
list / view / edit
list [-s|--state {open|closed|all}] [-L n] [--page n](default stateopen).view <project> [--by-name] [-w|--web].edit <project> [--by-name] [-t title] [-d description] [--card-type {text_only|images_and_text}].
gt project list --org acme --state all
gt project view Roadmap
gt project edit 3 --title "Roadmap 2026" --card-type images_and_text
close / reopen / delete
Each takes one or more projects; add --by-name to read numbers as titles.
gt project close Roadmap
gt project reopen 3 4 --org acme
gt project delete Roadmap --yes
Moving issues on a board
gt issue move moves an issue between a board's columns (see
issues.md). Moving issues on organization projects needs a token
that can write to the organization.
gt issue move 47 to "In progress"
gt issue move 47 in-progress --project Roadmap