118 lines
3.2 KiB
Markdown
118 lines
3.2 KiB
Markdown
---
|
|
name: gitea-cli
|
|
description: |
|
|
Use this skill whenever you need to interact with Gitea: creating pull requests,
|
|
listing issues, managing branches, checking PR status, or any other Gitea repo
|
|
operations in this project. The CLI tool is `tea`, already configured with login
|
|
`allanjsouza` pointing to `gitea.allanjsouza.cloud`. Use this skill any time the
|
|
user mentions PRs, pull requests, issues, Gitea, or asks you to open/create/list
|
|
anything on the remote repo — even if they don't say "tea" explicitly.
|
|
---
|
|
|
|
# Gitea CLI Skill (`tea`)
|
|
|
|
Gitea instance: `gitea.allanjsouza.cloud`
|
|
Login configured: `allanjsouza`
|
|
Repo remote: `ssh://git@gitea.allanjsouza.cloud:2222/allanjsouza/ctgwf.git`
|
|
|
|
## Critical: No-TTY Mode
|
|
|
|
`tea` tries to open an interactive TTY for some operations. This always fails in
|
|
Claude Code. Always pass all required fields as flags — never rely on interactive
|
|
prompts. When in doubt, check `tea <cmd> -h` and supply every required flag
|
|
explicitly.
|
|
|
|
## Creating a Pull Request
|
|
|
|
```bash
|
|
tea pulls create \
|
|
--title "feat: short description" \
|
|
--description "$(cat <<'EOF'
|
|
## Summary
|
|
- bullet 1
|
|
- bullet 2
|
|
|
|
## Test plan
|
|
- [ ] item
|
|
EOF
|
|
)" \
|
|
--base main \
|
|
--head <current-branch>
|
|
```
|
|
|
|
Key flags:
|
|
- `--base` — target branch (usually `main`)
|
|
- `--head` — source branch (current feature branch; defaults to current if omitted)
|
|
- `--title` — PR title (follow repo commit style: `type: description`)
|
|
- `--description` — PR body (use a heredoc to avoid quoting issues)
|
|
- `--assignees allanjsouza` — optionally assign to user
|
|
- `--labels "label1,label2"` — optionally add labels
|
|
|
|
**Always verify the current branch before creating a PR:**
|
|
```bash
|
|
git branch --show-current
|
|
```
|
|
|
|
**Push the branch first if not yet on remote:**
|
|
```bash
|
|
git push -u origin <branch>
|
|
```
|
|
|
|
## Listing PRs
|
|
|
|
```bash
|
|
tea pulls list # open PRs
|
|
tea pulls list --state all # all PRs
|
|
tea pulls list --output json # JSON output
|
|
```
|
|
|
|
## Listing Issues
|
|
|
|
```bash
|
|
tea issues list # open issues
|
|
tea issues list --state all
|
|
```
|
|
|
|
## Other Useful Commands
|
|
|
|
```bash
|
|
tea pulls list --fields index,title,state,author,updated
|
|
tea repo # show repo info
|
|
tea branches list # list branches
|
|
tea comment <issue-index> --body "…" # add comment
|
|
```
|
|
|
|
## Advanced API Operations (Review)
|
|
|
|
`tea api` handles the construction of a JSON body when using `-f` (string) and `-F` (typed) flags. It also automatically replaces `{owner}` and `{repo}` placeholders with values from the current repository context.
|
|
|
|
### Fetch PR Diff
|
|
```bash
|
|
tea api /repos/<owner>/<repo>/pulls/<index>.diff
|
|
```
|
|
|
|
### Submit a Review with Comments
|
|
```bash
|
|
tea api -X POST /repos/<owner>/<repo>/pulls/<index>/reviews \
|
|
-f "body=Automated Review" \
|
|
-f "event=COMMENT" \
|
|
-F "comments=@-" <<'EOF'
|
|
[
|
|
{
|
|
"path": "app/models/user.rb",
|
|
"body": "Suggestion content",
|
|
"new_position": 42,
|
|
"old_position": 0
|
|
}
|
|
]
|
|
EOF
|
|
```
|
|
|
|
## Workflow for PR Creation
|
|
|
|
1. Confirm all changes are committed: `git status`
|
|
2. Push branch: `git push -u origin <branch>`
|
|
3. Build PR title from commit history: `git log main.. --oneline`
|
|
4. Create PR with `tea pulls create` (all flags explicit, no prompts)
|
|
5. Return the PR URL from the `tea` output
|