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
72 lines
2.2 KiB
Markdown
72 lines
2.2 KiB
Markdown
# 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.
|
|
|
|
```text
|
|
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.
|
|
|
|
```bash
|
|
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 state
|
|
`open`).
|
|
- `view <project> [--by-name] [-w|--web]`.
|
|
- `edit <project> [--by-name] [-t title] [-d description]
|
|
[--card-type {text_only|images_and_text}]`.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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](issues.md)). Moving issues on organization projects needs a token
|
|
that can write to the organization.
|
|
|
|
```bash
|
|
gt issue move 47 to "In progress"
|
|
gt issue move 47 in-progress --project Roadmap
|
|
```
|