# Issue tracker: Gitea

Issues and PRDs for this repo live as Gitea issues on git.duoqi.me. Use the [`tea`](https://gitea.com/gitea/tea) CLI for all operations.

## Conventions

- **Create an issue**: `tea issues create --title "..." --description "..."`. Use a heredoc for multi-line descriptions.
- **Read an issue**: `tea issues view <number>`. Use `--output json` for machine-readable output.
- **List issues**: `tea issues list --output json` with appropriate `--labels` filters.
- **Comment on an issue**: `tea issues add-comment <number> --message "..."`.
- **Apply / remove labels**: `tea issues edit <number> --labels "..."`.
- **Close**: `tea issues close <number>`. Post the explanation first with `tea issues add-comment <number> --message "..."`, then close.
- **Pull requests**: Use `tea pr create`, `tea pr view`, `tea pr add-comment`, etc. — similar shape to `gh pr ...`.

Infer the repo from `git remote -v` — `tea` does this automatically when run inside a clone.

## When a skill says "publish to the issue tracker"

Create a Gitea issue.

## When a skill says "fetch the relevant ticket"

Run `tea issues view <number>`.