// Run GitHub Actions CI workflows locally using nektos/act in Docker. Use when testing CI before pushing or debugging workflow failures.
| name | gh-local |
| description | Run GitHub Actions CI workflows locally using nektos/act in Docker. Use when testing CI before pushing or debugging workflow failures. |
| disable-model-invocation | true |
| argument-hint | [job-name] [workflow-file] |
Run GitHub Actions CI workflows locally using nektos/act in Docker.
The user may specify:
.github/workflows/ci.yml.Verify prerequisites:
act is installed: which act. If not, tell the user to install it with brew install act.docker info. If not, tell the user to start Docker Desktop.Run the workflow:
catthehacker/ubuntu:act-latest image (small, ~2GB, cached after first pull).--container-architecture linux/amd64 for consistent behavior on Apple Silicon.act pull_request -j <job> --container-architecture linux/amd64 -P ubuntu-latest=catthehacker/ubuntu:act-latestact pull_request --container-architecture linux/amd64 -P ubuntu-latest=catthehacker/ubuntu:act-latestrun_in_background parameter and set timeout to 600000 (10 minutes).Monitor progress:
tail -50 on the output file.Report results:
catthehacker/ubuntu:act-latest image is minimal. If the workflow needs tools not in the base image (like browsers), they'll be installed via the workflow's own steps (e.g., npx playwright install-deps).act doesn't support actions/upload-artifact natively — those steps will fail but can be ignored.act.Test the Electron app interactively using Chrome DevTools Protocol. Use when the user asks to test, verify, or interact with the running app via browser automation.
Clear extension caches, analysis data, and drafts from the database. Use when testing sender lookups, analysis, or draft generation from a clean state.
Pre-commit code review for production-critical issues. Use when reviewing staged changes, before committing, or when asked to review code for bugs and consistency issues.
Iteratively improves a PR until all review bots (Greptile, Devin, and others) are satisfied with zero unresolved comments, then fixes any CI failures. Triggers reviews, fixes all actionable comments, pushes, re-triggers, and repeats. Use when the user wants to fully optimize a PR against all automated code review feedback.
Capture screenshots of the Exo Electron app workflows using Playwright in demo mode. Use when the user asks for screenshots, workflow documentation, or visual captures of the app.