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: A full-featured terminal user interface for managing and monitoring workflow executions
• Validate Workflow Files: Check for syntax errors and common mistakes in GitHub Actions workflow files with proper exit codes for CI/CD integration
• Execute Workflows Locally: Run workflows directly on your machine using Docker or Podman containers
• Multiple Container Runtimes: Support for Docker, Podman, and emulation mode for maximum flexibility
• Job Dependency Resolution: Automatically determines the correct execution order based on job dependencies
• Container Integration: Execute workflow steps in isolated containers with proper environment setup
• GitHub Context: Provides GitHub-like environment variables and workflow commands
• Rootless Execution: Podman support enables running containers without root privileges
• Action Support: Supports various GitHub Actions types:
  • Docker container actions
  • JavaScript actions
  • Composite actions
  • Local actions
• Special Action Handling: Native handling for commonly used actions like actions/checkout
• Reusable Workflows (Caller Jobs): Execute jobs that call reusable workflows via jobs.<id>.uses (local path or owner/repo/path@ref)
• Output Capturing: View logs, step outputs, and execution details
• Parallel Job Execution: Runs independent jobs in parallel for faster workflow execution
• Trigger Workflows Remotely: Manually trigger workflow runs on GitHub or GitLab

Check the project out at: GitHub - bahdotsh/wrkflw: Validate and Run GitHub Actions locally.

3 posts - 2 participants

Read full topic