forge-notifier

Matrix → Forgejo bridge. Receives task descriptions via Matrix, creates a Forgejo issue, applies a label to trigger an AI agent, then notifies when a pull request is opened.

Configuration

All config via environment variables:

Variable	Required	Default	Description
FORGEJO_URL	No	https://forge.jacquin.app	Forgejo instance URL
FORGEJO_TOKEN	Yes	—	API token with repo read/write
FORGE_REPO	Yes	—	owner/name of target repo
AGENT_LABEL	No	pi-agent	Label to apply to trigger the agent
POLL_INTERVAL_SECS	No	30	How often to poll for new PRs
MATRIX_HOMESERVER	No	—	Matrix server URL (disables Matrix if unset)
MATRIX_ACCESS_TOKEN	No	—	Matrix access token
MATRIX_CHARLES_ROOM_ID	No	—	Matrix room ID for Charles
MATRIX_SARAH_ROOM_ID	No	—	Matrix room ID for Sarah

Usage

Send any text message to the Matrix bot. The first line becomes the issue title, the rest becomes the body. The bot replies with the issue URL and notifies you when a PR is ready.

Building

just build-release

Development

just setup   # first time
just dev     # watch mode
just qa      # full check