WRKFLW is a powerful command-line tool for validating and executing GitHub Actions workflows locally, without requiring a full GitHub environment. It helps developers test their workflows directly on their machines before pushing changes to GitHub.
Features
TUI Interface
Provides a full-featured terminal user interface for managing and monitoring workflow executions.
Validate Workflow Files
Checks for syntax errors and common mistakes in GitHub Actions workflow files to ensure they are correct before execution.
Execute Workflows Locally
Runs workflows directly on your machine using Docker containers, eliminating the need for a GitHub environment.
Emulation Mode
Allows execution without Docker by emulating the container environment locally, providing flexibility in how workflows are tested.
Job Dependency Resolution
Automatically determines the correct execution order based on job dependencies to ensure accurate workflow runs.
Docker Integration
Executes workflow steps in isolated Docker containers with proper environment setup to mimic GitHub's runner environments.
GitHub Context
Provides GitHub-like environment variables and workflow commands to simulate the GitHub Actions environment as closely as possible.
Multiple Runtime Modes
Choose between Docker containers or local emulation to adapt to different testing scenarios and needs.
Action Support
Supports various GitHub Actions types, including Docker container actions, JavaScript actions, composite actions, and local actions.
Special Action Handling
Includes native handling for commonly used actions like actions/checkout to simplify workflow execution.
Output Capturing
Allows you to view logs, step outputs, and execution details to streamline debugging and monitoring.
Parallel Job Execution
Runs independent jobs in parallel to speed up the workflow execution process, making it more efficient.