LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

wrkflw

Validate and run GitHub Actions workflows locally

TLDR

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

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
copy
nix profile install nixpkgs#wrkflw
copy

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

Copied to clipboard
Kai