README.md

github-actions-toolbox

A CLI toolbox for GitHub Actions utilities.

Installation

Homebrew

brew install rlespinasse/tap/ghat

macOS Gatekeeper notice

On macOS, you may see a warning: "Apple is not able to verify that it is free from malware that could harm your Mac or compromise your privacy."

This is because the binary is ad-hoc signed but not notarized by Apple.

Note

Apple notarization requires a paid Apple Developer account ($99/year). It consists of an automated malware scan — not a manual security review or code audit — and does not guarantee the software is safe. Open-source projects can be verified by reviewing the source code and build pipeline directly.

To allow it to run, either:

• Via System Settings (UI): Go to System Settings > Privacy & Security, scroll down, and click Open Anyway next to the blocked app message.

• Via terminal:

  xattr -d com.apple.quarantine $(which ghat)

From source

go install github.com/rlespinasse/github-actions-toolbox@latest

Binary releases

Download pre-built binaries from the Releases page. Available for Linux, macOS, and Windows (amd64/arm64).

Usage

dependents — Get GitHub dependents count

Fetch the number of repository dependents from GitHub's dependency graph.

ghat dependents owner/repo

Query multiple repositories at once:

ghat dependents owner/repo1 owner/repo2

Pipe repositories via stdin:

echo "owner/repo" | ghat dependents

cat repos.txt | ghat dependents

Output format

Results are printed one per line:

owner/repo                          | deps | 42

The deps label is a clickable hyperlink (in supported terminals) pointing to the GitHub dependents page.

Development

This project uses just as a command runner.

just build    # Build the binary
just test     # Run all tests
just check    # Run fmt, vet, and test
just run dependents owner/repo  # Run without building

Releases are managed with goreleaser.