Commands for managing and monitoring workflow executions in SHAR.

Subcommands

list

Lists running executions, optionally filtered by workflow name.

Usage:

shar execution list [workflow_name]

Arguments:

  • workflow_name (optional) - Filter executions by workflow name

Example:

# List all executions
shar execution list

# List executions for a specific workflow
shar execution list "MyWorkflow"

Output: Returns a list of execution objects.


status

Gets the detailed status of a running execution.

Usage:

shar execution status <execution_id>

Arguments:

  • execution_id - The ID of the execution to query

Example:

shar execution status abc123

Output: Returns the execution status including all process instances and their current states.


cancel

Cancels a running process instance.

Usage:

shar execution cancel <process_instance_id>

Arguments:

  • process_instance_id - The ID of the process instance to cancel

Example:

shar execution cancel def456

Output: Confirms the cancelled process instance ID.


dump

Dumps the complete execution history.

Usage:

shar execution dump <execution_id>

Arguments:

  • execution_id - The ID of the execution to dump

Example:

shar execution dump abc123

Output: Returns the complete history of all process instances within the execution, sorted by timestamp.