Quickstart

This tutorial walks you through running the hello_world example workflow. You'll use cori check, cori run, and cori runs list to validate, execute, and inspect it.

Prerequisite: the Cori CLI is installed (cori --version works). See Install.

Get the example workflow

Clone the Cori repository and navigate to the hello_world example:

git clone https://github.com/cori-do/cori.git
cd cori/examples/hello_world

Alternatively, run it directly from a git ref (no clone needed):

cori run github.com/cori-do/cori/examples/hello_world

Validate the workflow

Before running, check that the workflow compiles and all activity requirements are satisfied:

cori check ./hello_world

cori check validates the manifest, resolves all step files, and verifies required tools and MCP servers are declared — without executing anything. If it passes cleanly, you're good to run.

Run the workflow

cori run ./hello_world

The first time you run a workflow, cori run automatically spawns a local Temporal dev server (temporal server start-dev) as a supervised child process. There's nothing else to install for solo local use.

You'll see output as each step completes. When the workflow finishes, the result is printed to stdout.

Read the trace

Every run writes a JSON trace to ~/.cori/runs/<key>/<utc>.json. You can inspect recent runs with:

cori runs list

To see the full trace for a specific run:

cori runs show <run-id>

To inspect the workflow itself (metadata + recent runs):

cori show ./hello_world

Check the runtime environment

To see the current endpoint, your identity, and any workers that are online:

cori status

You just ran a deterministic workflow with no LLM in the loop. Every time you run hello_world again, it executes identically.

Next: Capture a workflow from an agent conversation — this is where Cori's value really lands.