v0.1.0 — Initial public release

First public release of the GitHub Actions runner fleet and dashboard.

Originally developed as private tooling for a macOS runner fleet; this release
generalises it for public use on Apple Silicon Macs.

What's included

• Runner registration and management — register.sh, status.sh, health.sh, cleanup.sh
• Preflight check — infers host requirements from cached workflow data
• Dashboard daemon — live fleet view, run history, drift detection, analytics, autoscaling
• Queue cause classification — diagnoses why jobs are queued (8 classified causes)
• Drain and resume — graceful runner shutdown with hook integration
• Admission control — job execution throttling via runner hooks
• Historical simulation — what-if analysis against real job history
• Burst forecasting — next-hour demand estimates with shadow evaluation
• Diagnostic bundles — allowlist-based redacted runner diagnostics
• Ephemeral runners — one-job clean builds
• Federation — coordinate runners across multiple Macs

Requirements

• macOS 14+ on Apple Silicon
• Homebrew at /opt/homebrew
• gh CLI authenticated
• Node >= 22.5.0 (for the dashboard)

Getting started

git clone https://github.com/addisdev/actions-runners.git ~/actions-runners
cd ~/actions-runners
./preflight.sh
./register.sh owner/your-repo
cd dashboard && ./fleetctl.sh install

See the Installation guide
for the full setup walkthrough.

Security

⚠️ Self-hosted runners on public repositories are not supported — only private repos with trusted contributors.

Read SECURITY.md and security-hardening.md before deploying.

Known limitations

• macOS on Apple Silicon only (no Intel, Linux, or Windows)
• Screenshots and demo mode not included in this release (see docs/images/README.md)
• autofix/escalate/ AI escalation subtree is disabled by default and has not been independently audited