Commandpython

/act Command

Execute GitHub Actions locally using act

View Source

Act - GitHub Actions Local Execution

Execute GitHub Actions workflows locally using act: $ARGUMENTS

Current Workflows

  • Available workflows: !find .github/workflows -name "*.yml" -o -name "*.yaml" | head -10
  • Act configuration: @.actrc (if exists)
  • Docker status: !docker --version

Task

Execute GitHub Actions workflow locally:

  1. Setup Verification

    • Ensure act is installed: act --version
    • Verify Docker is running
    • Check available workflows in .github/workflows/
  2. Workflow Selection

    • If workflow specified: Run specific workflow $ARGUMENTS
    • If no workflow: List all available workflows
    • Check workflow triggers and events
  3. Local Execution

    • Run workflow with appropriate flags
    • Use secrets from .env or .secrets
    • Handle platform-specific runners
    • Monitor execution and logs
  4. Debugging Support

    • Use --verbose for detailed output
    • Use --dry-run for testing
    • Use --list to show available actions

Example Commands

# List all workflows
act --list

# Run specific workflow
act workflow_dispatch -W .github/workflows/$ARGUMENTS.yml

# Run with secrets
act --secret-file .env

# Debug mode
act --verbose --dry-run