List GitHub Runners By Organization

list_org_runners.py

#!/usr/bin/env python3

import requests
import argparse
import json
import csv
import sys

def get_org_runners(org, api_url, headers):
    url = f"{api_url}/orgs/{org}/actions/runners"
    response = requests.get(url, headers=headers)
    if response.status_code == 404:
        print(f"⚠️  No runners or org '{org}' not found.")
        return []
    response.raise_for_status()
    return response.json().get("runners", [])

def main():
    parser = argparse.ArgumentParser(description="List GitHub Actions self-hosted runners for organizations.")
    parser.add_argument("--token", required=True, help="GitHub Personal Access Token")
    parser.add_argument("--orgs", required=True, help="Comma-separated list of orgs (e.g., impinj,impinj-infra)")
    parser.add_argument("--output", choices=["json", "csv"], default="json", help="Output format (default: json)")
    parser.add_argument("--api-url", default="https://api.github.com", help="GitHub API URL")
    args = parser.parse_args()

    headers = {
        "Authorization": f"token {args.token}",
        "Accept": "application/vnd.github+json"
    }

    all_data = []
    org_list = [o.strip() for o in args.orgs.split(",")]

    for org in org_list:
        try:
            runners = get_org_runners(org, args.api_url, headers)
        except requests.HTTPError as e:
            print(f"❌ Failed to fetch runners for org {org}: {e}")
            continue

        for runner in runners:
            all_data.append({
                "organization": org,
                "runner_id": runner["id"],
                "name": runner["name"],
                "os": runner["os"],
                "status": runner["status"],
                "labels": ",".join(label["name"] for label in runner.get("labels", []))
            })

    if args.output == "csv":
        csv_file = "github_org_runners.csv"
        with open(csv_file, mode="w", newline="", encoding="utf-8") as f:
            writer = csv.DictWriter(f, fieldnames=["organization", "runner_id", "name", "os", "status", "labels"])
            writer.writeheader()
            writer.writerows(all_data)
        print(f"📄 CSV written to: {csv_file}")
    else:
        print(json.dumps(all_data, indent=2))

if __name__ == "__main__":
    main()