GitHub-Runner-Scaler-UI
Lighweight terminal app for monitoring GitHub Actions execution across multiple repositories. Optionally can automatically add more self-hosted runners on-demand.
Ficha actualizada 22 sept 2026, 21:21 · upstream 22 sept 2026, 21:15 · release v0.4.26
Qué es GitHub-Runner-Scaler-UI
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
runner-manager is a Rust-based tool that provides local-first autoscaling for ephemeral GitHub Actions self-hosted runners. It registers just-in-time runners, lets them complete one job and remove themselves afterwards, eliminating idle runner costs or inbound network service requirements. The agent survives reboots on Windows, macOS, and Linux by persisting state in the OS store rather than relying on a Docker container. Each repository can be configured with its own concurrency limits, workspace modes (ephemeral vs persistent), and runs-on labels for organization-level scaling. Credentials are kept in the operating system's secure credential store instead of being exposed to network services. The tool includes a TUI dashboard that displays live runner status, job progress, errors, and resource utilization.
- Monitor multiple GitHub Actions workflows running on self-hosted runners without maintaining persistent Docker containers
- Eliminate idle runner costs by auto-starting only when jobs are queued or waiting for resources
- Run Linux-based CI/CD pipelines on Windows machines using WSL2 distributions as runner hosts
- Scale out ephemeral runner instances across a team of development machines without network service dependencies
- Provide visibility into runner health, job completion rates, and resource consumption in real time
- Works behind NAT with no inbound ports required — runs purely over HTTP/REST API
- Starts completely clean on each invocation without leaving stale state or leftover processes
- Automatically survives reboots by persisting runner configuration and workspace data to the OS store
- Protects sensitive credentials by storing secrets in the operating system's secure credential manager rather than exposing them via network services
- Supports both ephemeral (single-use) and persistent workspace modes for flexible CI/CD workflows
- Provides a TUI dashboard with live status, job progress, error reporting, and resource metrics
- Requires Node.js 18 or newer to run the npm package version; Rust binary requires a pinned toolchain
- Does not support GitHub Actions self-hosted runners that require authentication tokens via webhook endpoints
- No built-in job scheduling or queue management — relies on external tools like GitHub CLI for workflow orchestration
- Limited to single-machine deployment without cross-platform runner sharing capabilities
- Workspace persistence requires manual configuration and does not automatically clean up after failed jobs
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Install via npm global package, Homebrew (macOS/Linux), or the curl install script. Use `runner-manager update --check` to verify version before updating. For Windows machines with WSL2, use `wsl install` to create a Linux distribution as an additional runner host. The service can be started automatically on boot via `service install`. Monitor capacity and resource usage with `host show`, then set limits with `set-capacity` or enable scaling with `set-scale`. For multi-repository monitoring, add repositories using `repo add --max-capacity N` to allow concurrent jobs per repository. The TUI dashboard is useful for on-call debugging but does not replace GitHub's native runner management UI.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.