Breakpoints & step
Pause at any step, run one line at a time, or run until the next breakpoint.
Inspect at pause
Peek inside the act container: workspace files, env, and workflow state while execution is frozen.
Matrix legs
Pick which matrix combination to debug instead of running the full Cartesian product blindly.
Expression re-eval
Re-run ${{ github.ref == 'refs/heads/main' }} and other workflow expressions at breakpoints to see why a condition failed.
How it fits together
Tool
Role
act
Run GHA workflows locally in Docker
ActDebug
Debug those runs — UI, API, VS Code extension
Quick start
git clone [email protected]:FirstIntegral/actdebug.git
cd actdebug
npm install && npm run install-deps
npm startOpens http://127.0.0.1:3847 — loopback only by default. Requires Docker for full uses: fidelity.
Privacy-first
- No accounts, telemetry, or cloud uploads
- Third-party actions blocked unless you explicitly trust them
- CSRF protection, path sandboxing, secrets redacted in API