Skip to content

actdbg 0.1.0 — stop at the failed step, get a shell

Choose a tag to compare

View all tags
@Socialpranker Socialpranker released this 11 Jun 06:06
v0.1.0
90c97eb

The missing debugger for GitHub Actions — first release.

  • actdbg run — run a workflow locally, stop at the failed step, keep the job container alive, and drop into a shell with the step's environment (workflow env chain + everything earlier steps wrote to $GITHUB_ENV/$GITHUB_PATH).
  • actdbg shell — re-enter that container any time later.
  • actdbg check — fidelity report: the known ways a local run differs from GitHub, found statically in your workflow, with line numbers.
  • actdbg doctor — your machine vs the classic act pitfalls (wrong image → command not found, arm64, docker group).
  • actdbg clean — remove leftover act-* containers/networks.

Install: go install github.com/Socialpranker/actdbg@latest (Docker required).

Honest by design: a green local run is not a green GitHub run — actdbg tells you where they differ instead of pretending they don't. Built on nektos/act as a library (pinned v0.2.89). The e2e suite runs the real thing on GitHub's own runners: fail a step → verify the container survived and the env was reconstructed.

Next (v0.2–v0.3): time-travel snapshots (rerun --from N), per-step file/env diffs, replay <github-run-url>.

Assets 2
Loading