gh-usage, developed by kukisama, is a command-line extension that surfaces GitHub Actions consumption directly in the terminal. It queries workflow minutes and storage usage and presents summaries without visiting the web UI. The extension reports per-repository details, billing-cycle comparisons, and integrates with existing gh authentication to reuse credentials. Intended for DevOps engineers, developers, and GitHub organization administrators, it brings quick, scriptable visibility to Actions resource patterns and helps spot heavy consumers from the command line.

How do you install and set up the extension?

Installation is a single gh extension command and requires the GitHub CLI to be present. Run gh extension install kukisama/gh-usage to add the extension. The tool depends on the existing gh environment, so ensure the CLI is authenticated and that the account has permission to read billing or organization data. On compatible desktops it runs where gh runs, including Windows systems with an installed GitHub CLI.

Does it keep credentials safe and use official APIs?

By reusing the existing GitHub CLI login, the extension does not prompt for separate credentials. It communicates with the official GitHub API to fetch usage metrics, so queries follow GitHub's permission model. Because the project is open source and lightweight, the code can be inspected before use, which reduces opaque behavior. The developer's choice to rely on gh's authentication centralizes credential handling rather than creating a parallel login flow.

Can it be scripted for organization-wide monitoring?

Because it runs as a command-line extension, the tool integrates into scripts and monitoring jobs without extra wrappers. Flags allow targeting specific accounts or organizations, making it possible to capture periodic snapshots for trend analysis. Niche developer communities note the extension's utility for tracking Actions consumption and spotting high-usage repositories. The developer maintains the project as open source, which supports adaptation into CI dashboards or scheduled reporting tasks.

Practical choice for terminal-first teams, recommended with a caveat

gh-usage is a practical option for DevOps engineers and organization administrators who need command-line visibility into Actions resource patterns. The main trade-off is dependency on the GitHub CLI and an account token that permits billing reads, which may limit use for some seats. Tip: run the extension on a scheduled runner or maintenance host to capture periodic snapshots for trend checks. Recommended.