wrkflw is a command-line tool for validating and running GitHub Actions workflows locally. It lets developers test workflows on their own machine before pushing changes to GitHub, helping catch syntax errors, job dependency issues, trigger mismatches, and runtime problems earlier in the development process.
The tool can run workflows through Docker, Podman, emulation, or a sandboxed secure emulation mode, and also offers an interactive terminal interface for managing workflows, logs, triggers, secrets, and execution details.
wrkflw also includes support for matrix builds, reusable workflows, composite actions, artifacts, caches, inter-job outputs, diff-aware filtering, watch mode, remote workflow triggering, and GitLab CI validation. This makes it useful for developers who want a local workflow testing environment without relying entirely on hosted CI runs.
This is free and open source software.
Key Features
- Validates GitHub Actions workflow files with syntax checks and structural validation.
- Runs workflows locally using Docker, Podman, emulation, or sandboxed secure emulation.
- Offers an interactive terminal interface with workflow, execution, DAG, log, trigger, secret, and help views.
- Supports watch mode to rerun workflows automatically when files change.
- Provides diff-aware filtering to skip workflows that wouldn’t match the simulated event and changed files.
- Runs individual jobs and resolves job dependencies automatically.
- Supports matrix builds, reusable workflows, composite actions, artifacts, caches, and inter-job outputs.
- Includes secrets handling with environment, file, Vault, AWS, Azure, and GCP providers.
- Can trigger remote GitHub workflow_dispatch runs and GitLab pipelines.
- Validates GitLab CI pipeline files.
- Cross-platform support – runs under Linux, macOS, and Windows.
Website: github.com/bahdotsh/wrkflw
Support:
Developer: Gokul
License: MIT License
wrkflw is written in Rust. Learn Rust with our recommended free books and free tutorials.
 Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |