Run and Troubleshoot Workflows
Inspect runs, compare attempts, and fix sync, event, log, or runner problems.
Start with the task or visible problem. Each guide tells you which run, event, workflow, or runner access you need.
Test before you push
Validate unpushed YAML
Check unpushed YAML and trigger eligibility without starting a run.
Run unpushed YAML
Replay validated YAML against a retained event and inspect the result.
Diagnose a problem
Debug a run with an agent
Have a coding agent trace a failed run or an event that did not start one.
A run didn't complete
Follow the job graph and compare executions or attempts.
Logs are missing
Read command output, agent sessions, and truncated streams.
An agent step fails
Repair provider, model, tool, integration connection, or runtime errors.
An event didn't start a run
Find why a delivered event did not create a run.
A workflow didn't sync
Find why repository YAML did not produce a usable definition.
A job stays pending
Match a pending job with an online runner.
Set Listener Success Rules
Control how a listening job's executions roll up into its final result. The example fails unless at least one event was processed and every execution succeeded.
Validate Unpushed YAML
Use a coding agent to check unpushed workflow YAML and trigger eligibility without starting a run.