List Output SDK workflow execution history. Use when finding failed runs, reviewing past executions, identifying workflow IDs for debugging, filtering runs by workflow type, or investigating recent workflow activity.
List workflow execution history to find failed runs, get workflow IDs for debugging, or investigate recent activity. Use when reviewing past executions or filtering runs by workflow type.
/plugin marketplace add growthxai/output-claude-plugins/plugin install growthxai-outputai-plugins-outputai@growthxai/output-claude-pluginsThis skill is limited to using the following tools:
This skill helps you view the execution history of workflows. Use it to find failed runs, identify workflow IDs for debugging, and review past executions.
npx output workflow runs list
By default, this shows the 100 most recent workflow executions across all workflow types.
| Flag | Description | Default |
|---|---|---|
--limit <n> | Number of runs to display | 100 |
--format <type> | Output format: table, json, text | table |
npx output workflow runs list <workflowName>
This shows only runs for the specified workflow type.
npx output workflow runs list --format json
Use JSON format for programmatic analysis or when you need full details.
| Status | Meaning | Action |
|---|---|---|
| RUNNING | Workflow is currently executing | Wait or monitor |
| COMPLETED | Workflow finished successfully | No action needed |
| FAILED | Workflow encountered an error | Debug with trace |
| TERMINATED | Workflow was manually stopped | Review if expected |
| TIMED_OUT | Workflow exceeded time limit | Check for long operations |
When viewing runs, pay attention to:
Scenario: Find failed workflow runs
# List recent runs and look for FAILED status
npx output workflow runs list --limit 20
# Or use JSON format with jq to filter
npx output workflow runs list --format json | jq '.[] | select(.status == "FAILED")'
Scenario: Get workflow ID for debugging
# List runs for a specific workflow
npx output workflow runs list my-workflow --limit 5
# Note the workflow ID from the output (e.g., "abc123xyz")
# Then debug it
npx output workflow debug abc123xyz --format json
Scenario: Review recent activity for a specific workflow
# See the last 10 runs of the data-pipeline workflow
npx output workflow runs list data-pipeline --limit 10
Scenario: Export run history for analysis
# Get all recent runs as JSON for external analysis
npx output workflow runs list --format json > workflow-runs.json
Scenario: Find when failures started
# Look at more history to find patterns
npx output workflow runs list --limit 50 --format json | jq 'group_by(.status) | map({status: .[0].status, count: length})'
npx output workflow debug <workflowId> --format jsonnpx output workflow debug <id> - Analyze execution tracenpx output workflow status <id> - Check current statusnpx output workflow result <id> - Get execution resultnpx output workflow list - List available workflowsThis skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.