---
name: gitea
description: Interact with Gitea repositories using tea CLI. Use when managing issues, pull requests, releases, repos, labels, milestones on gitea.kostverse.com
allowed-tools: Bash
---

# Gitea Management via tea CLI

You have access to the `tea` CLI for managing Gitea repositories. This is a lightweight alternative to the Gitea MCP.

## Authentication

Already configured:
- Login: `kostverse`
- URL: `https://gitea.kostverse.com`
- User: `matt`

Always use `--login kostverse` with commands.

## Common Operations

### Issues

**List issues:**
```bash
tea issues list --repo OWNER/REPO --login kostverse
```

**Create issue:**
```bash
tea issues create --repo OWNER/REPO --login kostverse \
  --title "Issue title" \
  --description "Issue body" \
  --labels "bug,enhancement" \
  --assignees "username"
```

**Close issue:**
```bash
tea issues close ISSUE_NUMBER --repo OWNER/REPO --login kostverse
```

**Comment on issue:**
```bash
tea comment ISSUE_NUMBER --repo OWNER/REPO --login kostverse \
  --body "Comment text"
```

### Pull Requests

**List PRs:**
```bash
tea pulls list --repo OWNER/REPO --login kostverse
```

**Create PR:**
```bash
tea pulls create --repo OWNER/REPO --login kostverse \
  --head BRANCH --base main \
  --title "PR title" \
  --description "PR body"
```

**Merge PR:**
```bash
tea pulls merge PR_NUMBER --repo OWNER/REPO --login kostverse
```

### Repositories

**List repos:**
```bash
tea repos list --login kostverse
```

**Clone repo:**
```bash
tea clone OWNER/REPO --login kostverse
```

### Labels

**List labels:**
```bash
tea labels list --repo OWNER/REPO --login kostverse
```

**Create label:**
```bash
tea labels create --repo OWNER/REPO --login kostverse \
  --name "label-name" \
  --color "ff0000" \
  --description "Label description"
```

### Releases

**List releases:**
```bash
tea releases list --repo OWNER/REPO --login kostverse
```

**Create release:**
```bash
tea releases create --repo OWNER/REPO --login kostverse \
  --tag v1.0.0 \
  --title "Release title" \
  --note "Release notes"
```

### Milestones

**List milestones:**
```bash
tea milestones list --repo OWNER/REPO --login kostverse
```

**Create milestone:**
```bash
tea milestones create --repo OWNER/REPO --login kostverse \
  --title "Milestone name" \
  --description "Milestone description" \
  --deadline "2026-12-31"
```

## Tips

1. **Always use `--login kostverse`** - Specifies which Gitea instance to use
2. **Repo format** - Use `OWNER/REPO` format (e.g., `matt/aurai-v2`)
3. **Help** - Use `tea COMMAND --help` for detailed options
4. **Output** - Most commands output tables or formatted text
5. **Error handling** - Check exit codes and stderr for failures

## Example Workflows

### Triage new issue
1. `tea issues list --repo matt/REPO --login kostverse` - See all issues
2. Read the issue details
3. Add labels: `tea issues create` with `--labels` flag
4. Assign: `tea issues create` with `--assignees` flag

### Create PR from feature branch
1. Make commits locally
2. Push branch to Gitea
3. `tea pulls create --repo matt/REPO --login kostverse --head feature-branch --base main --title "..." --description "..."`
4. Get PR URL from output

### Ship a release
1. Tag the commit: `git tag v1.0.0 && git push origin v1.0.0`
2. `tea releases create --repo matt/REPO --login kostverse --tag v1.0.0 --title "v1.0.0" --note "Release notes here"`
3. Verify at output URL