Skip to main content

When to use

  • Debug a workflow execution that failed or returned unexpected results
  • Inspect node-level input/output for a specific execution
  • Fetch sub-workflow execution details recursively
  • Analyze execution timing and identify bottlenecks

Prerequisites

  • codika CLI installed and authenticated
  • A deployed and triggered workflow
  • An execution ID (from the trigger command response)

Typical debugging flow

Command

Arguments

Options

For most debugging, use both flags together:
  • --deep gives you the complete execution tree including sub-workflows
  • --slim removes noisy metadata for cleaner, more readable output

Process instance ID resolution

  1. --process-instance-id flag
  2. devProcessInstanceId in --project-file (if provided)
  3. devProcessInstanceId in project.json at --path
  4. devProcessInstanceId in project.json in current directory

Deep mode

When --deep is used, the CLI recursively fetches sub-workflow executions and attaches them as _subExecutions on the parent node that triggered them. This gives you the complete execution tree.

How it works

  1. Fetches the main execution
  2. Identifies nodes that called sub-workflows (Execute Workflow nodes)
  3. Recursively fetches each sub-workflow execution
  4. Attaches results as _subExecutions on the parent node
This builds a complete execution tree for multi-workflow use cases.

Slim mode

Strips noisy fields for cleaner output:
  • Removes pairedItem from all nodes
  • Removes workflowData from execution metadata
Best used with --deep for debugging: --deep --slim

Examples

Output

Exit codes