---
trigger: model_decision
description: The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata.
---

```markdown
# Gitea CLI (tea) Integration Guidelines

The repository is connected to a private Gitea instance. The workspace contains a configured and pre-authenticated Gitea CLI (`tea`) tool that you must use to manage issue tickets, pull requests, and repository metadata.

## 1. CLI Location & Login Context
- **Binary Path**: `/usr/local/bin/tea`
- **Gitea Base URL**: `https://git.i3omb.com`
- **Username**: `Gandalf`
- **Active Authenticated Login**: `sofarr` (Pre-configured with scopes `write:user,write:issue`)
- **Target Repository Slug**: `Gandalf/sofarr`

## 2. Mandatory Non-Interactive Usage Rules
The CLI commands must be run non-interactively to avoid blocking terminal processes or prompting for user inputs.
- Always explicitly pass the `--login sofarr` (or `-l sofarr`) flag.
- Always explicitly pass the `--repo Gandalf/sofarr` (or `-r Gandalf/sofarr`) flag.

## 3. Common Operations Reference

### Listing Issues
```bash
/usr/local/bin/tea issues list --login sofarr --repo Gandalf/sofarr --state all
```

### Creating an Issue with Labels
```bash
/usr/local/bin/tea issues create \
  --login sofarr \
  --repo Gandalf/sofarr \
  --title "BUG: [Brief Title]" \
  --description "[Detailed description of the issue, reproducing steps, and context]" \
  --labels "Kind/Bug"
```

### Adding/Editing Labels on an Existing Issue
To add labels without removing existing ones:
```bash
/usr/local/bin/tea issues edit \
  --login sofarr \
  --repo Gandalf/sofarr \
  --add-labels "Kind/Bug,Priority/High" \
  <issue_index>
```
To remove labels:
```bash
/usr/local/bin/tea issues edit \
  --login sofarr \
  --repo Gandalf/sofarr \
  --remove-labels "Priority/Low" \
  <issue_index>
```

### Commenting on an Issue/PR
```bash
/usr/local/bin/tea comment \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index> "[Resolution or update details]"
```

### Closing an Issue
```bash
/usr/local/bin/tea issues close \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index>
```

### Reopening an Issue
```bash
/usr/local/bin/tea issues reopen \
  --login sofarr \
  --repo Gandalf/sofarr \
  <issue_index>
```

## 4. Standard Labels Reference
Always use one or more of the following pre-configured labels when creating or updating issues:

| Type | Label Name | Description |
|---|---|---|
| **Kinds** | `Kind/Bug` | Something is not working |
| | `Kind/Feature` | New functionality |
| | `Kind/Enhancement` | Improve existing functionality |
| | `Kind/Documentation` | Documentation changes |
| | `Kind/Security` | Security issues and patches |
| | `Kind/Testing` | Issue or PR related to testing |
| **Priorities** | `Priority/Critical` | Critical/blocking issue |
| | `Priority/High` | High priority |
| | `Priority/Medium` | Medium priority |
| | `Priority/Low` | Low priority |
| **Compatibility** | `Compat/Breaking` | Breaking change that won't be backward compatible |
| **Review** | `Reviewed/Confirmed` | Issue has been confirmed/verified |
| | `Reviewed/Duplicate` | Duplicate of another issue or PR |
| | `Reviewed/Invalid` | Invalid issue or question |
| | `Reviewed/Won't Fix` | Decision made not to address this issue |
| **Status** | `Status/Blocked` | Blocked by other dependencies/tasks |
| | `Status/Abandoned` | Work started but currently abandoned |
| | `Status/Need More Info` | Awaiting more feedback/information to proceed |

## 5. Verification Check
To verify login configurations and connectivity without making modifications, use:
```bash
/usr/local/bin/tea logins list
```
To list all active labels in the repository:
```bash
/usr/local/bin/tea labels list --login sofarr --repo Gandalf/sofarr
```
```
***