| name | act.quickstart |
| description | Agent workflow for running, listing, validating, and testing GitHub Actions workflows locally via act CLI. |
| tags | act,github-actions,ci-cd,testing,automation,docker,workflows |
act Quickstart
Use this when AI agents need to run GitHub Actions workflows locally before pushing to GitHub.
1) Install plugin and dependency
supercli plugins learn act
curl -s https://raw.githubusercontent.com/nektos/act/master/install.sh | sh
act --version
supercli plugins install ./plugins/act --on-conflict replace --json
2) Validate CLI wiring
act --version
docker --version
supercli plugins doctor act --json
3) Prerequisites
Workflow files must exist in .github/workflows/ directory.
ls -la .github/workflows/
mkdir -p .github/workflows
4) Core command patterns
List workflows
supercli act workflow list
Run workflows
supercli act workflow run
supercli act workflow run --event pull_request
supercli act workflow run --job test
supercli act workflow run --secrets '["GITHUB_TOKEN=xxx","API_KEY=yyy"]'
Validate workflows
supercli act workflow validate
supercli act workflow dryrun
Watch mode (auto-reload)
supercli act workflow watch
Job-specific run
supercli act job run --job build
Secrets management
supercli act secret list
supercli act secret add --name GITHUB_TOKEN --value xxx
5) Docker Requirements
act runs workflows in Docker containers:
- Docker must be running
- Default images:
catthehacker/ubuntu:act-latest
- Custom images:
act -P ubuntu-latest=my-custom-image
- No Docker:
act -P ubuntu-latest=-self-hosted
6) Agent workflow: Test before push
supercli act workflow list
supercli act workflow run --dryrun true
supercli act workflow run --job test
supercli act workflow run
7) Safety levels
| Command | Level | Description |
|---|
workflow list, validate, dryrun, secret list | safe | Read-only or validate |
workflow run, job run, secret add | guarded | Runs containers |
workflow watch | guarded | Continuous execution |
Guard commands may require Docker resources. Use --dryrun true to validate first.