# Gitea

> Gitea operations via tea CLI. Use when user mentions: gitea, tea, or when git remote shows a Gitea instance.

- Skill: `aiskillstore/gitea` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/gitea`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/gitea/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/gitea

---


# Gitea CLI (tea)

## When to Use This Skill

Use `tea` for Gitea repositories. To detect Gitea, check if the remote is not GitHub or GitLab:
```bash
git remote -v
```

If the remote doesn't contain `github.com` or `gitlab`, it may be a Gitea instance.

## Before Any Operation

Always verify authentication first:
```bash
tea login list
```

If not authenticated, guide the user to run `tea login add`.

## Behavioral Guidelines

1. **Creating PRs**: Always check for uncommitted changes first with `git status`
2. **CI Operations**: Check pipeline status before triggering new runs
3. **Use `--output`**: For machine-readable output, use `-o json` or `-o yaml`

## Command Reference

### Pull Requests
| Action | Command |
|--------|---------|
| Create | `tea pr create --title "Title" --description "Desc"` |
| List | `tea pr list` |
| View | `tea pr view <id>` |
| Checkout | `tea pr checkout <id>` |
| Merge | `tea pr merge <id>` |

### Issues
| Action | Command |
|--------|---------|
| Create | `tea issue create --title "Title" --body "Desc"` |
| List | `tea issue list` |
| List open | `tea issue list --state open` |
| View | `tea issue view <id>` |
| Close | `tea issue close <id>` |
| Comment | `tea issue comment <id> "Comment"` |

### Repository
| Action | Command |
|--------|---------|
| Clone | `tea repo clone <owner/repo>` |
| Fork | `tea repo fork <owner/repo>` |

### Output Formats
For JSON output (useful for scripting):
```bash
tea issue list -o json
tea pr list -o json
```