temporal
Operate Temporal workflows in this repo: start/list/inspect workflows, fetch history, debug nondeterminism, reset/cancel/terminate, and check task queues via Temporal CLI.
When & Why to Use This Skill
This Claude skill provides a comprehensive interface for managing and debugging Temporal workflows via the Temporal CLI. It simplifies complex operational tasks such as starting workflows, inspecting execution history, and resolving nondeterminism through precise resets. By integrating workflow tracing and task queue monitoring, it empowers developers and SREs to maintain system reliability and quickly recover from execution failures.
Use Cases
- Debugging Workflow Failures: Retrieve full JSON history and trace executions to pinpoint the exact step where a distributed process failed.
- Fixing Nondeterminism: Reset a workflow to a specific event ID or the 'FirstWorkflowTask' to recover from determinism errors after code deployments.
- Workflow Lifecycle Management: Start, cancel, or terminate workflows based on custom queries, such as filtering for specific workflow types or execution statuses.
- Infrastructure Health Checks: Inspect task queues and fetch worker logs via kubectl to diagnose latency or processing bottlenecks in the Temporal cluster.
| name | temporal |
|---|---|
| description | "Operate Temporal workflows in this repo: start/list/inspect workflows, fetch history, debug nondeterminism, reset/cancel/terminate, and check task queues via Temporal CLI." |
Temporal
Overview
Operate workflows with explicit namespace, address, and task queue. Use repo scripts for starting workflows, then use the CLI to inspect and control them.
Connection
export TEMPORAL_ADDRESS=temporal-grpc.ide-newton.ts.net:7233
export TEMPORAL_NAMESPACE=default
export TEMPORAL_TASK_QUEUE=bumba
Validate connectivity:
temporal --namespace "$TEMPORAL_NAMESPACE" workflow list --limit 5
From UI URL to CLI args
Example UI URL:
http://temporal/namespaces/default/workflows/bumba-repo-0e6476cd-6df7-4ee3-8184-95029cd50c88/019b7788-e535-752c-8a4a-2ee44de7065e/history
Derive:
export WORKFLOW_ID=bumba-repo-0e6476cd-6df7-4ee3-8184-95029cd50c88
export RUN_ID=019b7788-e535-752c-8a4a-2ee44de7065e
Inspect workflows
Describe:
temporal --namespace "$TEMPORAL_NAMESPACE" workflow describe --workflow-id "$WORKFLOW_ID" --run-id "$RUN_ID"
History (JSON):
temporal --namespace "$TEMPORAL_NAMESPACE" workflow show --workflow-id "$WORKFLOW_ID" --run-id "$RUN_ID" --output json > /tmp/workflow-history.json
Trace:
temporal --namespace "$TEMPORAL_NAMESPACE" workflow trace --workflow-id "$WORKFLOW_ID" --run-id "$RUN_ID"
List and filter
temporal --namespace "$TEMPORAL_NAMESPACE" workflow list --limit 20
temporal --namespace "$TEMPORAL_NAMESPACE" workflow list --query 'WorkflowType="enrichFile" and ExecutionStatus="Running"'
temporal --namespace "$TEMPORAL_NAMESPACE" workflow list --query 'WorkflowType="enrichRepository" and ExecutionStatus="Failed"'
Start workflows (repo scripts)
enrichRepository:
bun run packages/scripts/src/bumba/enrich-repository.ts --path-prefix services/bumba --max-files 50 --wait
enrichFile:
bun run packages/scripts/src/bumba/enrich-file.ts --file services/bumba/src/worker.ts --wait
Reset nondeterminism
- Use
workflow showto locate the last good event ID. - Reset to
FirstWorkflowTaskor the safe event. - Confirm the new run replays deterministically.
temporal --namespace "$TEMPORAL_NAMESPACE" workflow reset --workflow-id "$WORKFLOW_ID" --run-id "$RUN_ID" --reason "reset to known-good event" --event-id 31 --reset-type FirstWorkflowTask
Cancel / terminate
temporal --namespace "$TEMPORAL_NAMESPACE" workflow cancel --workflow-id "$WORKFLOW_ID"
temporal --namespace "$TEMPORAL_NAMESPACE" workflow terminate --workflow-id "$WORKFLOW_ID" --reason "manual cleanup"
Task queues / workers
temporal --namespace "$TEMPORAL_NAMESPACE" task-queue describe --task-queue "$TEMPORAL_TASK_QUEUE"
Worker logs
kubectl logs -n jangar deploy/bumba --tail=200
Resources
- Reference:
references/temporal-cli.md - Runner:
scripts/temporal-run.sh - Triage template:
assets/temporal-triage.md