CLI reference
All eight Cori CLI verbs with full synopses, flags, and environment variables.
Cori has exactly eight verbs. There is no cori init, cori save, cori register, cori workers, cori ls, cori rm, cori serve, cori push, cori pull, or cori workflows command.
cori run
cori run <path-or-ref> [--json] [--dry-run] [--update] [--yes] [<param>=<value>...]Run a workflow. <path-or-ref> is either a local folder path or a git ref.
| Flag | Description |
|---|---|
--json | Output the workflow result as JSON to stdout |
--dry-run | Plan the workflow without executing any activities |
--update | Re-resolve remote refs (fetch latest matching version) |
--yes | Skip the first-run consent prompt for remote workflows |
<param>=<value> | Pass parameter values; may be repeated |
Example:
cori run ./translate_product_sheets_fr \
input_file=products.csv \
spreadsheet_id=1BxiM... \
--jsoncori check
cori check <path-or-ref> [--update] [--yes]Validate a workflow: verify the manifest, compile step files, check declared tools. Does not execute.
| Flag | Description |
|---|---|
--update | Re-resolve remote refs |
--yes | Skip first-run consent for remote refs |
cori show
cori show <path-or-ref>Display a workflow's metadata (name, description, parameters, tools required) and its recent runs.
cori runs
cori runs list
cori runs show <run-id>cori runs list — list recent workflow runs with timestamps and status.
cori runs show <run-id> — display the full JSON trace for a specific run.
cori work
cori work [--shared <name>]Start a long-lived worker process.
- Without
--shared: listens on your identity-derived task queue. Makes this machine available as a worker for workflows you run from other machines. --shared <name>: join the named shared pool. Workflows can dispatch steps to this pool by declaringtask_queue: <name>.
cori login
cori login <capability>Authenticate a capability (e.g., a specific MCP server or LLM provider). Stores the credential in the OS keychain.
cori status
cori statusShow the current Temporal endpoint, your identity, and any workers that are currently online.
There is no cori workers status. Use cori status.
cori config
cori config get <key>
cori config set <key> <value>Read or write values in ~/.cori/config.toml.
Examples:
cori config get temporal.host
cori config set temporal.host temporal.mycompany.com:7233
cori config set llm.openai.api_key sk-...Environment variables
| Variable | Effect |
|---|---|
CORI_TEMPORAL_TARGET | Override Temporal endpoint (takes precedence over config file) |
CORI_ASSUME_YES | When set to 1, skip first-run consent prompts (--yes equivalent) |
CORI_REAUTH_TIMEOUT_SECS | Timeout in seconds for re-authentication prompts |
CORI_DENO | Path to the Deno binary (if not on PATH) |