Bundled Kasm Workspaces Chromium + Playwright claimer that visits Epic Games, Amazon Prime Gaming, and GOG to claim free items on a schedule. Log in once from any device via the Kasm web UI (HTTPS over a single TCP port — works behind any reverse proxy / Cloudflare tunnel / Tailscale node); the browser profile persists on a mounted volume.

All configuration is via environment variables.

Mount /data to persist the browser profile (/data/profile).

The Kasm web UI is exposed on port 6901 (HTTPS).

services:
  agc:
    image: agc:dev
    environment:
      RUN_MODE: schedule
      CRON_SCHEDULE: "0 12 * * *"
      TZ: Europe/Berlin
      VNC_PW: changeme
      APPRISE_URLS: "ntfy://ntfy.example.com/claims"
    ports:
      - "6901:6901"
    volumes:
      - claimer-data:/data
    restart: unless-stopped
volumes:
  claimer-data: {}

Open https://localhost:6901 (accept the self-signed cert), log in with username kasm_user and the password you set in VNC_PW, then drive the browser to Epic / Prime / GOG and sign in. The profile in /data/profile is reused by every scheduled claim run.

Deployment with 1 replica, PVC mounted at /data, Service + Ingress (with TLS termination if you want — Kasm self-signs by default) to port 6901.

CronJob with the same image, RUN_MODE=once, sharing the profile PVC. The container is only alive during runs; it shuts down cleanly when the claimer pass finishes.

1. Create src/sites/<name>.ts exporting a SiteClaimer.
2. Add a CLAIM_<NAME> env var to src/config.ts.
3. Wire it in src/sites/registry.ts.
4. Add fixture-based tests under test/sites/.

bun install
bunx playwright install chromium
bun test
bun run typecheck

To rebuild and smoke-test the container locally:

docker build -f docker/Dockerfile -t agc:dev .
docker run --rm -p 6901:6901 -v $PWD/data:/data \
  -e VNC_PW=password \
  -e RUN_MODE=schedule -e CRON_SCHEDULE="0 12 * * *" \
  agc:dev