Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

How to Track Workflow Status

Monitor a running workflow's progress using the CLI, TUI, or dashboard.

Quick Status Check

torc reports summary <workflow_id>

Example output:

Workflow 42: data_pipeline

Jobs by Status:
  Completed:  45
  Running:     5
  Ready:      10
  Blocked:    40

Continuous Monitoring

Watch status update every 10 seconds:

watch -n 10 torc reports summary <workflow_id>

Interactive TUI

Launch the terminal UI for a visual dashboard:

torc tui

The TUI shows:

  • Job status breakdown with progress bars
  • Running job details
  • Failed job information
  • Real-time updates

List Individual Jobs

View job-level status:

# All jobs
torc jobs list <workflow_id>

# Filter by status
torc jobs list <workflow_id> --status running
torc jobs list <workflow_id> --status failed

Check Completion

Verify if a workflow has finished:

torc workflows is-complete <workflow_id>

For scripting:

if torc -f json workflows is-complete "$WORKFLOW_ID" | jq -e '.is_complete' > /dev/null; then
    echo "Workflow complete"
fi

See Also