Git Clients

wrkflw – validate and run CI workflows locally

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 in action
Click animation for full size

wrkflw is written in Rust. Learn Rust with our recommended free books and free tutorials.


Related Software

Git Workflow Tools
git-extrasSuperb collection of tools for Git
forgitUtility for using git interactively
wrkflwValidate and run GitHub Actions workflows locally
git-branchlessBranchless workflow for git
git-absorbSuper-charging git rebase
git-toolbeltSuite of useful Git commands
git-openAdds a handy git open command to Git.
git-townAutomate the creation, synchronization, shipping, and cleanup
git-fuzzyInteractive git with the help of fzf
git-recentJump between recently used local Git branches
git-macheteRobust tool that simplifies your git workflows
git-flow-nextModern implementation of the Git-flow branching model
Git Interactive Rebase ToolTerminal-based sequence editor for interactive rebase
git-crecordInteractively select changes to commit or stage
git-xargsUpdate across multiple GitHub repositories
git-prompt.zshLightweight git prompt for zsh
gh-stackGitHub CLI extension for managing stacked pull requests
drydockMonitor unfinished work across multiple Git repositories
git reviseGit subcommand and Python library
wtpEnhanced Git worktree management
LazyWorktreeGit worktree management for the terminal
gwmCreate and manage isolated Git worktrees from the terminal
git-spiceCreate, rebase and submit stacks of dependent Git branches
git-smartSmall collection of Git helper commands
staxCLI and TUI for stacked Git branches and PRs
git-fixupCommand-line helper for Git users
git-autofixupGit helper that creates fixup commits for topic branches
BranchletCreate and manage Git worktrees

Read our verdict in the software roundup.


Best Free and Open Source Software 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.
Subscribe

Please read our Comment Policy before commenting.

Notify of
guest
0 Comments
Oldest
Newest Most Voted