How kunchenguid/runner-up works
runner-up self-hosts GitHub Actions jobs across machines, giving each job a fresh container, VM, or account, with host execution also available. Administrators initialize setup and add machines; during service, the coordinator receives queued work through GitHub runner scale sets, applies ordering and resource rules, and launches a one-job runner through the machine’s agent. The agent provisions the configured execution environment and starts GitHub’s runner, which then works with GitHub directly. The graph preserves documented provider, recovery, setup-reload, and update capabilities. Some subsystem links are based on README descriptions because their implementation excerpts were not shown.
Main entry points: service.go Coordinator service · jobhost.go One-job host · config.go Setup configuration · agent.go Remote agent
Components 22
Setup and control
- CLI commands
cmd/main.go - Setup and machines
cmd/init.go - Setup configuration
internal/config/config.go
Coordinator
- GitHub sessions
internal/coordinator/github.go - Coordinator service
internal/coordinator/service.go - Waiting job state
internal/coordinator/queue.go - Order rules
internal/plan/rules.go - Resource planner
internal/plan/plan.go - Place runner
internal/coordinator/place.go
Machine execution
- Remote agent
internal/agent/agent.go - One-job host
internal/agent/jobhost.go - Linux providers
internal/agent/kvm_linux.go - Mac providers
internal/agent/tart.go - Windows providers
internal/agent/jobhost_windows.go - Windows service
internal/agent/service_windows.go
Resilience and updates
- Restart recovery
internal/coordinator/snapshot.go - Setup reload
internal/coordinator/reload.go - Program updates
internal/coordinator/update.go
Other components
- Administrator
- GitHub Actions
- Runner scale sets
- GitHub job runner
Connections 22
- Administrator → CLI commands: runs commands
README.md - CLI commands → Setup and machines: initializes setup
cmd/main.go - Setup and machines → Setup configuration: writes setup
cmd/init.go - GitHub Actions → Runner scale sets: queues jobs
README.md - Runner scale sets → GitHub sessions: delivers job messages
README.md - GitHub sessions → Coordinator service: feeds coordination
internal/coordinator/service.go - Setup configuration → Coordinator service: configures coordinator
README.md - Coordinator service → Waiting job state: tracks waiting jobs
internal/coordinator/service.go - Coordinator service → Order rules: parses order rules
internal/coordinator/service.go - Coordinator service → Resource planner: plans assignments
internal/coordinator/service.go - Coordinator service → Place runner: launches place runner
README.md - Place runner → Remote agent: runs agent over SSH
README.md - Remote agent → One-job host: starts one-job host
README.md - One-job host → Linux providers: provisions job environment
- One-job host → Mac providers: provisions job environment
- One-job host → Windows providers: provisions job environment
- Windows providers → Windows service: requests privileged work
- Remote agent → GitHub job runner: starts runner
README.md - GitHub job runner → GitHub Actions: works with GitHub
README.md - Coordinator service → Restart recovery: restores running state
- Setup configuration → Setup reload: triggers setup changes
README.md - Coordinator service → Program updates: checks configured release