Install

The easiest way to get Cori is the desktop app — one download that bundles the whole engine, plus a one-click way to get the CLI. The agent skill is a separate install: it teaches a coding agent how to author workflows.

Install the Cori desktop app (recommended)

Grab the installer for your platform from cori.do (or the releases page):

macOS — Cori.dmg (Apple Silicon or Intel). Drag into Applications, then open.
Windows — Cori.msi. Double-click and follow the installer.
Linux — Cori.AppImage (executable bundle) or Cori.deb (Debian / Ubuntu).

The app lives in your menu bar / system tray and runs workflows without touching a terminal — see Use the Console for a tour.

Want the cori command too? The launcher's footer has an Install CLI button that puts the bundled CLI on your PATH — no separate download. If you don't see the button, cori is already installed.

Install the Cori CLI (terminal-first alternative)

If you'd rather skip the desktop app entirely, the install script sets up the CLI on its own:

curl -fsSL https://cli.cori.do/install.sh | bash

Verify it worked:

cori --version

The CLI is the binary that runs, checks, and inspects workflows. You need it (or the desktop app) on every machine where workflows execute.

Install the Cori agent skill

npx skills add cori-do/cori

This installs the cori-save-workflow skill into your coding agent. Supported agents: Claude Code, Cursor, Gemini CLI, Copilot.

The agent skill is not a CLI subcommand — it's a separate package that extends your coding agent. It does not need to be on the machine that runs workflows; it only needs to be in the agent environment where you author them.

Prerequisites

Node.js ≥ 20 — required for step files (TypeScript is compiled and run by the CLI). The desktop app bundles its own runtime, so this only applies to the standalone CLI.

The desktop app ships with everything it needs — engine, runtime, and Temporal. The CLI install script likewise downloads the Temporal CLI alongside the Cori binary. For solo local use, cori run automatically spawns a local Temporal dev server the first time you run a workflow. You don't need to install or configure anything for local development.

For production deployments, point Cori at an existing Temporal cluster via temporal.host in ~/.cori/config.toml or the CORI_TEMPORAL_TARGET environment variable. See Configure Temporal.

Next: run your first workflow

With the desktop app installed, open the launcher and paste cori-do/workflows to run your first workflow — or follow the Console tour.

With the CLI installed, you're ready to run a workflow from the terminal. Head to Quickstart.

With the skill installed in your agent, you're ready to capture your first workflow. Head to Capture from an agent conversation.