wrkflw

Validate and run GitHub Actions workflows locally

TLDR

Launch the interactive TUI
$ wrkflw
Validate workflows in the repo
$ wrkflw validate
Run a workflow locally
$ wrkflw run [workflow.yml]

SYNOPSIS

wrkflw [*command*] [*options*]

DESCRIPTION

wrkflw validates and executes GitHub Actions workflows on your machine using Docker, Podman, or secure emulation. It offers a TUI for browsing workflows, execution logs, DAGs, triggers, and secrets—useful before pushing CI changes.

PARAMETERS

validate

Structural/syntax checks on workflow files.
run *workflow*
Execute locally with container or emulation backend.
Default TUI mode lists workflows and past runs. See wrkflw --help for watch mode and backend flags.

INSTALL

brew install wrkflw
nix profile install nixpkgs#wrkflw

CAVEATS

Not every GitHub-hosted capability is reproducible offline (actions marketplace, OIDC, service networking). Docker socket access has security implications. Secrets handling must stay local.

SEE ALSO

act(1), docker(1), gh(1)

RESOURCES

Source code