All apps/Temporal CLI

Temporal CLI

temporal

Command-line interface for running Temporal Server and interacting with Workflows, Activities, Namespaces, and other parts of Temporal.

Runs as temporal|macOS, Linux, Windows|docs.temporal.io

Command form

ai-draft · 3 tasks · 16 fields

Common Workflow jobs: list, start and describe Workflow Executions. Global connection flags (address, namespace, profile) and the other subcommands are left out.

Opens the form; the finished command lands at your prompt, unrun
otty gui temporal

temporal workflow list

List workflows

List Workflow Executions, optionally filtered by a List Filter query.

List workflowsExample values, fixed in this page — nothing here reaches a terminal
Basic
List filter query*
string
Max results
integer
TasksEach one presets the form for one job
Filtered list
querylimit
ParametersOnly these flags are editable in the form
List filter query
SQL-like filter, e.g. WorkflowType = 'MyWorkflow'.
string
--query-q
Max results
integer
--limit
Page size
integer
--page-size
Archived only
boolean
--archived

temporal workflow start

Start a workflow

Start a new Workflow Execution. Headers, memo, search attributes, fairness and priority options are left out.

Start a workflowExample values, fixed in this page — nothing here reaches a terminal
Basic
Workflow type*
string
Task queue*
string
Workflow ID
string
Input
string
TasksEach one presets the form for one job
Start with input
typetask_queueworkflow_idinput
ParametersOnly these flags are editable in the form
Workflow type
string
--type
Task queue
string
--task-queue-t
Workflow ID
If empty, the Service generates a unique ID.
string
--workflow-id-w
Input
JSON value. Repeat for multiple arguments.
string · repeatable
--input-i
ID conflict policy
enum
--id-conflict-policyFailUseExistingTerminateExisting
ID reuse policy
enum
--id-reuse-policyAllowDuplicateAllowDuplicateFailedOnlyRejectDuplicateTerminateIfRunning
Cron schedule
string
--cron
Execution timeout
Duration, e.g. 30m.
string
--execution-timeout
Run timeout
Duration, e.g. 10m.
string
--run-timeout

temporal workflow describe

Describe a workflow

Show the properties of a Workflow Execution.

Describe a workflowExample values, fixed in this page — nothing here reaches a terminal
Basic
Workflow ID*
string
Run ID
string
TasksEach one presets the form for one job
Describe
workflow_idrun_id
ParametersOnly these flags are editable in the form
Workflow ID
string
--workflow-id-w
Run ID
string
--run-id-r
Raw output
boolean
--raw
SourcesEvery flag above is checked against these
ref
temporal workflow list --query YourQuery --archived No bool Limit output to archived Workflow Executions. (Experimental) --limit No int Maximum number of Workflow Executions to display. --page-size No int Maximum number of Workflow Executions to fetch at a time from the server. --query, -q No string Content for an SQL-like QUERY List Filter.
manual2026-10-27

docs.temporal.io

ref
temporal workflow start --workflow-id YourWorkflowId --type YourWorkflow --task-queue YourTaskQueue --input '{"some-key": "some-value"}' --cron No string Cron schedule for the Workflow. --execution-timeout No duration Fail a WorkflowExecution if it lasts longer than DURATION. This time-out includes retries and ContinueAsNew tasks. --id-conflict-policy No st…
manual2026-10-27

docs.temporal.io

ref
temporal workflow describe --workflow-id YourWorkflowId --raw No bool Print properties without changing their format. --reset-points No bool Show auto-reset points only. --run-id, -r No string Run ID. --workflow-id, -w Yes string Workflow ID.
manual2026-10-27

docs.temporal.io

Before it fills your prompt, Otty checks the installed temporal against its version. A form that does not match your version is not offered.