Rerun Workflow From a Step

Rerun Workflow From a Step

Overview

This skill resets a workflow to re-run from after a specific completed step. The current run is terminated and a new run is created that replays the workflow up to the given step (reusing its recorded output), then re-executes every step after it.

Use this to avoid re-running expensive early steps (like LLM calls or slow HTTP requests) when you only need to iterate on a later step.

When to Use This Skill

• A workflow failed late, but every step before the failure succeeded — rerun from after the last known-good step instead of starting over
• You edited a prompt or step function that only affects steps after step N, and want to validate the change against the same upstream inputs
• You want to branch off an existing run for debugging without re-paying the cost of its earlier LLM/API calls
• Investigating non-determinism in a later step and want to hold earlier outputs constant

When NOT to Use This Skill

• The workflow is still running — stop it first with npx output workflow stop <id> or terminate <id>
• The target step never completed — reset requires a completed step to replay up to (returns a 409)
• You actually want a clean run from scratch — use npx output workflow run <name> or workflow start <name>
• Earlier steps had side effects you need to re-execute (e.g. writes to an external system) — the replay skips them

Instructions

Basic Syntax

npx output workflow reset <workflowId> --step <stepName>
npx output workflow reset <workflowId> --step <stepName> --reason "<why>"

The workflowId argument is required. The step name is the step function name as it appears in the trace (e.g. fetchArticle, consolidateCompetitors).

Finding the Step Name