ACT Setup¶

Run GitHub Actions workflows locally using ACT.

Installation¶

macOS¶

brew install act

Linux¶

curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash

Usage¶

List Available Workflows¶

act --list

Run Specific Workflows¶

# Run CI pipeline
act -W .github/workflows/ci.yml

# Run specific jobs
act -W .github/workflows/ci.yml -j lint-and-format
act -W .github/workflows/ci.yml -j test
act -W .github/workflows/ci.yml -j build

Troubleshooting¶

pnpm Not Found¶

Use full Ubuntu image with pnpm pre-installed.

Network Issues¶

act --network host

Verbose Debugging¶

act --verbose
act --debug