dblagbro/claude-coordinator-self-hosted-helper

coordinator-hub-helper is a minimal phase‑2 helper service for a coordinator-hub. It registers with the hub (POST /api/cluster/helpers/register) using an install password or a pre-issued token, persists the issued token to /etc/helper/token, and sends a JSON‑RPC heartbeat every 15s to /api/cluster/dispatch (helpers.heartbeat). It reports basic host metrics (load1, free_ram_mb, free_disk_gb). Who uses it: hub operators and cluster admins deploying lightweight helper containers to appear in the hub’s Helpers list and prepare for future work execution. Key features: - Register/adopt workflow with token persistence (700 perms, helper user) - Periodic heartbeat with JSON‑RPC - Configurable via env vars (HUB_URL, HELPER_LABEL, HELPER_INSTALL_PASSWORD or HELPER_TOKEN, capabilities, tags, slots, heartbeat interval, token file) - Docker quick-start and build instructions included Limitations: phase 2 does not accept dispatch.sync or execute Playwright/GPU workloads—those are planned for phase 3.

AI-related keywords found in this repo's description, topics, or README summary — grouped by category. Each badge links to the corresponding ranking detail page.