gh-actions-updater

pnpm package for the gau Rust CLI.

pnpm add -g gh-actions-updater
gau --help

Run without installing globally:

pnpm dlx gh-actions-updater@latest --check .
pnpm dlx gh-actions-updater@latest --init

Common usage:

gau --init
gau --check .
gau --update --diff .
gau --latest --check .
gau --latest-tag --update .
gau --latest-hash --update .
gau --pin-style major --update .
gau -r ~/workspace --check

The package name is gh-actions-updater; the installed commands are gau and the ghau alias. The postinstall script downloads the matching gau binary from GitHub Releases, verifies the release checksum, and stores it in the package vendor directory. No platform binaries are checked into the package.

Configuration lives in .gh-actions-updater.toml. Generate one with:

gau --init
gau --init --recursive --force

Useful flags:

• --latest: preserve each reference's tag or SHA representation
• --latest-tag: update to compatible semantic-version tags (default)
• --latest-hash: select compatible releases and pin their commit SHAs
• --cache-ttl <DURATION>: 15m, 6h, 7d, 0, or never
• --no-cache: disable cache reads and writes
• --refresh-cache: force fresh metadata
• -r, --recursive: scan nested repositories/workspaces
• --pin-style <preserve|major|minor|full>: control semver tag pin formatting
• --threads <N>: override Rayon available-core default
• --format json: machine-readable output

Skip specific updates with config:

[update]
exclude = ["actions/checkout", "owner/repo/.github/workflows/deploy.yml@v*"]

Or inline:

- uses: actions/checkout@v4 # gau: ignore

See the repository README for the complete CLI and configuration reference.