Commandpython
/act Command
Execute GitHub Actions locally using act
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:
-
Setup Verification
- Ensure act is installed:
act --version - Verify Docker is running
- Check available workflows in
.github/workflows/
- Ensure act is installed:
-
Workflow Selection
- If workflow specified: Run specific workflow
$ARGUMENTS - If no workflow: List all available workflows
- Check workflow triggers and events
- If workflow specified: Run specific workflow
-
Local Execution
- Run workflow with appropriate flags
- Use secrets from
.envor.secrets - Handle platform-specific runners
- Monitor execution and logs
-
Debugging Support
- Use
--verbosefor detailed output - Use
--dry-runfor testing - Use
--listto show available actions
- Use
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