A CLI tool that lets developers step through GitHub Actions workflows with breakpoints and an interactive shell, locally, without pushing to GitHub

Every GitHub Actions failure sends developers into a push-wait-fail loop that burns 10 to 30 minutes per iteration. nektos/act runs workflows locally but offers no breakpoints, no step-through, and no interactive shell access to inspect state mid-run. Existing workarounds like action-tmate pause on failure via SSH but do not support pre-set breakpoints or step-over commands. A paid CLI tool that brings a proper step-through debugger to GitHub Actions would cut debug cycles from hours to minutes.

Demand Breakdown

GitHub

72,600

122

Social Proof 3 sources

nektos/act - Run your GitHub Actions locally

@nektos · 2019-01-01

72,600 HN

The Pain That Is GitHub Actions

@hn · 2025-03-20

100 HN

Show HN: PipeStep - Step-through debugger for GitHub Actions workflows

@hn · 2026-03-12

Gap Assessment

CompetitiveMultiple tools exist but differentiation opportunities remain

4 tools exist (nektos/act, PipeStep, action-tmate, namespacelabs/breakpoint) but gaps remain: No breakpoints, no step-over, no interactive shell into a specific step mid-run. All-or-nothing execution with no way to pause and inspect state.; Early-stage indie project with 22 HN engagements and no commercial model, no Windows support, limited runner compatibility..

Features8 agent-ready prompts

Local breakpoint execution engine

▶

Interactive step-through CLI debugger

▶

Workflow YAML breakpoint annotation format

▶

Secrets and context injection

▶

Step output and artifact inspection

▶

Re-run from step without restarting the whole workflow

▶

VS Code extension integration

▶

Paid tier and team license management

▶

Competitive LandscapeFREE

Product	Does	Missing
nektos/act	Runs GitHub Actions workflows locally inside Docker, replicating the runner environment without pushing to GitHub.	No breakpoints, no step-over, no interactive shell into a specific step mid-run. All-or-nothing execution with no way to pause and inspect state.
PipeStep	Interactive CI pipeline debugger that steps through GitHub Actions workflows locally with Docker, allows pausing before each step and dropping into a shell.	Early-stage indie project with 22 HN engagements and no commercial model, no Windows support, limited runner compatibility.
action-tmate	Pauses a GitHub Actions run on failure and opens an SSH shell into the runner via tmate so you can inspect the environment live.	Requires modifying the workflow YAML, runs on GitHub-hosted runners only (not local), no pre-set breakpoints, no step-over commands.
namespacelabs/breakpoint	Adds SSH-accessible pause points to CI runs so you can jump in and debug live when a step fails.	Cloud-runner dependent, no local execution, no step-through or step-over commands, requires adding a breakpoint action to each step explicitly.