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
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# gitea-gt-cli
|
|
|
|
An [Agent Skill](https://agentskills.io) for **`gt`**, the official Gitea CLI
|
|
(the successor to `tea`), covering repositories, branches, issues, pull
|
|
requests, reviews, projects, releases, Actions runs/workflows/runners, secrets,
|
|
variables, packages, organizations, extensions, and authentication.
|
|
|
|
## Install
|
|
|
|
Listed on [skills.sh](https://skills.sh/raucao/gitea-gt-cli/gitea-gt-cli):
|
|
|
|
```bash
|
|
# Default (GitHub, tracks skills.sh)
|
|
npx skills add raucao/gitea-gt-cli
|
|
|
|
# Global / a specific agent
|
|
npx skills add raucao/gitea-gt-cli -a opencode -g
|
|
|
|
# From the upstream Gitea instance
|
|
npx skills add https://gitea.kosmos.org/raucao/gitea-gt-cli.git
|
|
```
|
|
|
|
Without the `skills` CLI, copy `SKILL.md` and the `references/` directory into
|
|
your agent's skills directory, for example `~/.agents/skills/gitea-gt-cli/` or
|
|
`.agents/skills/gitea-gt-cli/`.
|
|
|
|
## What's inside
|
|
|
|
The skill is the repository root:
|
|
|
|
```text
|
|
.
|
|
├── SKILL.md # when to use gt, auth, core concepts, command map, gotchas
|
|
├── references/
|
|
│ ├── workflows.md # end-to-end recipes (issues, PRs, backports, Actions, projects, releases)
|
|
│ ├── auth.md # auth, doctor, setup-git, env vars
|
|
│ ├── repos.md # repo, branch, browse
|
|
│ ├── issues.md # issue, label, milestone
|
|
│ ├── pull-requests.md # pr (reviews, checks, diff, backport, merge, status)
|
|
│ ├── projects.md # project
|
|
│ ├── releases.md # release
|
|
│ ├── organizations.md # org, team
|
|
│ ├── actions.md # run, workflow
|
|
│ ├── runners.md # runner
|
|
│ ├── ci-config.md # secret, variable, package
|
|
│ ├── discovery.md # search, status, notification, time
|
|
│ ├── instance.md # config, api, alias, completion, webhook, wiki, ssh-key, admin
|
|
│ └── extensions.md # extension, upgrade
|
|
├── README.md
|
|
└── LICENSE
|
|
```
|
|
|
|
`SKILL.md` stays small and maps each command group to a focused reference file,
|
|
so the agent loads only the detail it needs.
|
|
|
|
## Requirements
|
|
|
|
- `gt` 1.0.0 or newer (`gt version`)
|
|
- A Gitea instance running **28 or newer**
|
|
|
|
Install `gt` itself from the official source:
|
|
[gitea.com/gitea/cli](https://gitea.com/gitea/cli) (releases, install script and
|
|
source) or [dl.gitea.com/gitea-cli](https://dl.gitea.com/gitea-cli/) (prebuilt
|
|
binaries); `gt upgrade` keeps it current.
|
|
|
|
## License
|
|
|
|
[Unlicense](LICENSE) — public domain.
|