Release Tracker

A Zig application that monitors releases from starred repositories across GitHub, GitLab, Codeberg, and SourceHut, generating an RSS feed for easy consumption.

Needs to be able to rotate PAT on GitLab

Features

• Monitor releases from multiple Git hosting platforms
• Generate RSS feed of new releases
• Configurable authentication for each platform
• Designed to run periodically as a CLI tool
• Static file output suitable for deployment on Cloudflare Pages

Building

Requires Zig 0.14.1:

zig build

Usage

1. Copy config.example.json to config.json and fill in your API tokens
2. Run the application:

./zig-out/bin/release-tracker config.json

3. The RSS feed will be generated as releases.xml

Configuration

Create a config.json file with your API tokens:

{
  "github_token": "your_github_token",
  "gitlab_token": "your_gitlab_token", 
  "codeberg_token": "your_codeberg_token",
  "sourcehut": {
    "repositories": [
      "~sircmpwn/aerc",
      "~emersion/gamja"
    ]
  },
  "last_check": null
}

API Token Setup

• GitHub: Create a Personal Access Token with public_repo and user scopes
• GitLab: Create a Personal Access Token with read_api scope
• Codeberg: Create an Access Token in your account settings
• SourceHut: No token required for public repositories. Specify repositories to track in the configuration.

Testing

Run the test suite:

zig build test

Run integration tests:

zig build test -Dintegration=true

Enable debug output in tests (useful for debugging test failures):

zig build test -Dintegration=true -Dtest-debug=true

Test individual providers:

zig build test-github
zig build test-gitlab
zig build test-codeberg
zig build test-sourcehut

Deployment

This tool is designed to be run periodically (e.g., via cron) and commit the generated RSS file to a Git repository that can be deployed via Cloudflare Pages or similar static hosting services.

Example cron job (runs every hour):

0 * * * * cd /path/to/release-tracker && ./zig-out/bin/release-tracker config.json && git add releases.xml && git commit -m "Update releases" && git push