# Issue tracker: Forgejo

Issues and PRDs for this repo live as Forgejo issues. Use the `fj` CLI for all
operations.

## Commands

- **Create an issue**: `fj issue create "Title" --body-file <file>` or `fj issue create "Title" --body "..."`
- **Read an issue body**: `fj issue view <number>`
- **Read comments**: `fj issue view <number> comments`
- **Search issues**: `fj issue search --state open --labels "needs-triage"`
- **Comment on an issue**: `fj issue comment <number> --body-file <file>` or `fj issue comment <number> "..."`
- **Apply / remove labels**: `fj issue edit <number> labels --add "..."` / `fj issue edit <number> labels --rm "..."`
- **Close**: `fj issue close <number> --with-msg "..."`

When run inside a local clone, prefer `-R origin` only if `fj` cannot infer the
repo from the current working directory.

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

Create a Forgejo issue with `fj issue create`.

## When a skill says "fetch an issue"

Run `fj issue view <number>` and `fj issue view <number> comments`.

## When a skill says "apply a label"

Run `fj issue edit <number> labels --add "<label>"`.