56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# gitea-gt-cli
|
|
|
|
An [Agent Skill](https://agentskills.io) for **`gt`**, the official Gitea CLI
|
|
(the rewrite of `tea`), covering repositories, issues, pull requests, reviews,
|
|
releases, Actions, packages, organizations, and authentication.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
npx skills add https://gitea.kosmos.org/raucao/gitea-gt-cli.git
|
|
|
|
# Specific agent / global
|
|
npx skills add https://gitea.kosmos.org/raucao/gitea-gt-cli.git -a opencode -g
|
|
```
|
|
|
|
Without the `skills` CLI, copy `skills/gitea-gt-cli/` into your agent's skills
|
|
directory, for example `~/.agents/skills/gitea-gt-cli/` or
|
|
`.agents/skills/gitea-gt-cli/`.
|
|
|
|
## What's inside
|
|
|
|
```text
|
|
skills/gitea-gt-cli/
|
|
├── SKILL.md # when to use gt, auth, core concepts, command map, gotchas
|
|
└── references/
|
|
├── workflows.md # end-to-end recipes (issues, PRs, Actions, releases, fork/sync)
|
|
├── auth.md # auth, doctor, setup-git, env vars
|
|
├── repos.md # repo, branch
|
|
├── issues.md # issue, label, milestone
|
|
├── pull-requests.md # pr (reviews, checks, diff, merge, status)
|
|
├── releases.md # release
|
|
├── organizations.md # org, team
|
|
├── actions.md # run, workflow
|
|
├── ci-config.md # secret, variable, package
|
|
├── discovery.md # search, status, notification, time
|
|
└── instance.md # config, api, alias, completion, webhook, wiki, ssh-key, admin
|
|
```
|
|
|
|
`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` 0.1.0 or newer (`gt version`)
|
|
- A Gitea instance running **28 or newer**
|
|
|
|
Install `gt` itself with:
|
|
|
|
```bash
|
|
curl -fsSL https://gitea.com/gitea/cli/raw/branch/main/scripts/install.sh | sh
|
|
```
|
|
|
|
## License
|
|
|
|
[Unlicense](LICENSE) — public domain.
|