PipeStep – Step-through debugger for GitHub Actions workflows
Raw Developer Origin & Technical Request
Hacker News
Mar 13, 2026
Hey HN — I kept seeing developers describe the same frustration: the commit-push-wait-read-logs cycle when debugging CI pipelines. So I built PipeStep.PipeStep parses your GitHub Actions YAML, spins up the right Docker container, and gives you a step-through debugger for your run: shell commands.You can:
1. Pause before each step and inspect the container state.
2. Shell into the running container mid-pipeline (press I).
3. Set breakpoints on specific steps (press B).
4. Retry failed steps or skip past others.It deliberately does not try to replicate the full GitHub Actions runtime — no secrets, no matrix builds, no uses: action execution. For full local workflow runs, use act. PipeStep is for when things break and you need to figure out why without pushing 10 more commits. Think of it as gdb for your CI pipeline rather than a local GitHub runner.pip install pipestep (v0.1.2) · Python 3.11+ · MIT · Requires DockerWould love feedback, especially from people who've hit the same pain point. Known limitations are documented in the README + have some issues in there that I'd love eyeballs on!
Developer Debate & Comments
No active discussions extracted for this entry yet.
Engagement Signals
Cross-Market Term Frequency
Quantifies the cross-market adoption of foundational terms like act and Docker by tracking occurrence frequency across active SaaS architectures and enterprise developer debates.
Market Trends