What it is
ghrunners checks the local Mac for GitHub Actions
self-hosted runner installs, launchd state, process state, logs,
and optional GitHub API status. It reports the result as a quiet
table or JSON, with typed findings when something looks wrong.
Current local snapshot
Local/private status: local tag v0.1.1. The current
CLI includes status, describe, and
logs; API enrichment is opt-in via --api.
What's different about it
The tool is deliberately read-only and partial-output friendly. Permission-denied paths become row-level findings instead of fatal errors, and missing sudo or missing GitHub API access is reflected in provenance rather than hidden.
Next
Public source link comes after the repository is reachable. Control verbs such as start, stop, and restart are outside the current local/private scope.
What it isn't
- Not a runner installer or unregister tool.
- Not a daemon or persistent monitor.
- Not Linux or Windows tooling.
- Not fleet management.
- Not a public-source project until the repository is reachable.