# Issue tracker: Gitea

Issues and PRDs for this repo live as issues in the self-hosted Gitea remote:

- Remote: `http://82.157.175.59:3000/GenarrativeAI/Genarrative.git`
- Tracker type: Gitea Issues

## Conventions

- Prefer the Gitea `tea` CLI when it is installed and configured for this host.
- Do not use GitHub `gh` or GitLab `glab` for this repo unless the repository is explicitly migrated to those platforms.
- If `tea` is unavailable, use the Gitea Web UI or Gitea REST API for the same operations.

## Common operations with `tea`

Exact flags can vary by `tea` version. Run `tea issues --help` or `tea issue --help` before using a command in a new environment.

- Create an issue: `tea issues create --title "..." --body "..."`
- Read an issue: `tea issues view <number>`
- List issues: `tea issues list`
- Comment on an issue: use the installed `tea` issue comment command shown by `tea issues --help`; if unavailable, use the Gitea Web UI or REST API.
- Apply labels: use the installed `tea` issue update/edit command shown by `tea issues --help`; if unavailable, use the Gitea Web UI or REST API.
- Close an issue: use the installed `tea` issue close/update command shown by `tea issues --help`; if unavailable, use the Gitea Web UI or REST API.

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

Create a Gitea issue in `GenarrativeAI/Genarrative` with the requested title, body, labels, and links back to any relevant docs or branch.

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

Read the Gitea issue body and comments/notes for the referenced issue number. Include labels and current open/closed state in the working context.

## Authentication

Use the locally configured Gitea credentials for the current developer. Do not commit tokens, cookies, `.env`, or local credential files.