wrkflw is a command-line tool for validating and executing continuous integration workflows locally. Developers can check workflow definitions, reproduce failing jobs and inspect execution results before pushing changes to a remote repository.
Although primarily designed for GitHub Actions, its capabilities extend to GitLab CI and Gitea workflows. It provides several execution backends, allowing developers to test jobs using containers, emulation or Kubernetes infrastructure. An interactive terminal interface brings workflow management, execution history and diagnostics together.
The software is useful for projects with complicated CI configurations, particularly those involving dependent jobs, matrix builds, reusable workflows and external services. Local testing can reduce unnecessary hosted CI runs and make troubleshooting faster.
This is free and open source software.
Key Features
- Validates workflow syntax, structure and composite action inputs.
- Executes jobs using Docker, Podman, emulation, secure emulation or Kubernetes.
- Interactive terminal interface with workflow, execution, history, dispatch and setup views.
- Supports GitHub Actions, GitLab CI and Gitea workflow definitions.
- Runs individual jobs while resolving dependencies and executing independent jobs in parallel.
- Supports matrix builds, including dynamically generated matrices, inclusion rules and parallelism limits.
- Executes composite actions, JavaScript actions, container actions and reusable workflows.
- Handles workflow artifacts, dependency caches and inter-job outputs.
- Supports service containers with health checks when using Docker or Podman.
- Watch mode automatically reruns relevant workflows when files change.
- Diff-aware filtering identifies workflows affected by modified files and simulated events.
- Secrets management with environment variables, files, Vault and cloud secret providers.
- Provides JSON output, execution history, workflow planning and an MCP server.
- Can trigger remote GitHub Actions workflows and GitLab pipelines.
- Cross-platform support – runs on 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.
Related Software
| Git Workflow Tools | |
|---|---|
| git-extras | Superb collection of tools for Git |
| forgit | Utility for using git interactively |
| wrkflw | Validate and run GitHub Actions workflows locally |
| git-branchless | Branchless workflow for git |
| git-absorb | Super-charging git rebase |
| git-toolbelt | Suite of useful Git commands |
| git-open | Adds a handy git open command to Git. |
| git-town | Automate the creation, synchronization, shipping, and cleanup |
| git-fuzzy | Interactive git with the help of fzf |
| git-recent | Jump between recently used local Git branches |
| git-machete | Robust tool that simplifies your git workflows |
| git-flow-next | Modern implementation of the Git-flow branching model |
| Git Interactive Rebase Tool | Terminal-based sequence editor for interactive rebase |
| git-crecord | Interactively select changes to commit or stage |
| git-xargs | Update across multiple GitHub repositories |
| git-prompt.zsh | Lightweight git prompt for zsh |
| gh-stack | GitHub CLI extension for managing stacked pull requests |
| drydock | Monitor unfinished work across multiple Git repositories |
| git revise | Git subcommand and Python library |
| wtp | Enhanced Git worktree management |
| LazyWorktree | Git worktree management for the terminal |
| gwm | Create and manage isolated Git worktrees from the terminal |
| git-spice | Create, rebase and submit stacks of dependent Git branches |
| git-smart | Small collection of Git helper commands |
| stax | CLI and TUI for stacked Git branches and PRs |
| git-fixup | Command-line helper for Git users |
| git-autofixup | Git helper that creates fixup commits for topic branches |
| Branchlet | Create and manage Git worktrees |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.