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]

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.

RESOURCES

Source code