Skip to content

luxass/actioneer

actioneer

actioneer detects outdated GitHub Actions references in your workflows and updates them to the latest versions or pinned SHAs.

Install

Homebrew (macOS and Linux)

brew install luxass/homebrew-tap/actioneer

Cargo

cargo install --locked actioneer

GitHub Releases

Pre-built binaries are available for Linux, macOS, and Windows at github.com/luxass/actioneer/releases.

Quick Start

actioneer --dry-run
actioneer --yes
actioneer audit

By default, actioneer scans .github. Use --recursive to scan from the current directory, or pass a file or directory explicitly.

What It Does

  • Finds GitHub Actions references in workflow YAML.
  • Resolves newer tags through the GitHub API.
  • Rewrites references either as SHAs or preserved tags.
  • Detects SHA/comment mismatches before you trust pinned actions.
  • Supports interactive use, CI validation, and JSON output.

Notes

  • Updates are rewritten as pinned SHAs with version comments by default. Use --pin tag to write tag refs instead.
  • Use --min-release-age 30m, 12h, or 7d to skip tags released too recently.
  • audit exits non-zero on SHA/comment mismatches.
  • Interactive selection requires a TTY.
  • Set GITHUB_TOKEN if you want higher GitHub API rate limits.
  • Workflow security analysis runs in CI via zizmor.

Workflow Security Checks

This repository uses zizmor to statically analyze GitHub Actions workflows. zizmor itself is a Rust tool, and the upstream project ships both a Cargo-installable CLI and a GitHub Action wrapper.

For local use, install it with Cargo:

cargo install --locked zizmor
just zizmor .

The CI integration lives in .github/workflows/zizmor.yaml and uploads results through GitHub code scanning.

Build From Source

Build the Rust CLI directly:

cargo build
./target/debug/actioneer --help

For local iteration:

cargo run -- --dry-run
cargo test

📄 License

Published under MIT License.

About

CLI that detects outdated GitHub Actions and updates them to the latest versions or pinned SHAs

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors