Installation

Installation

As a gh extension

gh extension install waznggo/gh-reenact
gh reenact <run-url>

You already have gh, and reenact uses it for authentication anyway. The help text follows the name it was invoked under, so examples you copy from gh reenact --help work as typed.

The extension lives in a second repository because gh extension install refuses any repository whose name does not start with gh-. It is built from the tag in this repository, never from vendored code.

Single binary

curl -fsSL https://raw.githubusercontent.com/waznggo/reenact/main/install.sh | sh

Detects your platform, verifies the SHA-256 against the release's checksums.txt and refuses to install if it does not match. Installs to ~/.local/bin unless REENACT_BIN says otherwise.

From source

go install github.com/waznggo/reenact/cmd/reenact@latest

Go 1.26+. The version is read from the module, so reenact version still tells you what you have.

Requirements

	needed for
A GitHub token	everything — gh auth login is enough, or set GITHUB_TOKEN
Docker	reproduction only
act	reproduction only

reenact inspect and --dry-run need neither Docker nor act. They are useful on their own: they tell you which step failed, in which matrix leg, at which commit, and what the run needed.

Private repositories

The token needs the repo scope:

gh auth refresh -s repo