workflows-install

Zapier Workflows Early Access Install

Imperative recipe. Each step gates the next. Do not skip a step that failed.

This is the public-first EA path. It uses the Zapier SDK CLI and does not install the legacy @zapier/zapier-sdk-code-substrate package.

Flow

flowchart TD
  probe["1. Probe environment"] --> envOk{"Node 18+, npm, git OK?"}
  envOk -->|no| stopEnv["STOP: tell user what to install"]
  envOk -->|yes| installCli["2. Install or update SDK CLI"]
  installCli --> verifyExperimental["3. Verify experimental commands"]
  verifyExperimental --> commandsOk{"Code Workflows commands visible?"}
  commandsOk -->|no| stopCli["STOP: diagnose SDK CLI install"]
  commandsOk -->|yes| checkAuth["4. Check Zapier auth"]
  checkAuth --> authOk{"JSON has data and no errors?"}
  authOk -->|no| login["4b. Ask user to run interactive login"]
  login --> checkAuth
  authOk -->|yes| checkAccess["5. Check Zapier Workflows EA access"]
  checkAccess --> accessOk{"Read-only workflow list succeeds?"}
  accessOk -->|no| stopAccess["STOP: closed beta access required"]
  accessOk -->|yes| installSkills["6. Bootstrap companion skills"]
  installSkills --> report["7. Report success and next steps"]

What This Installs

• @zapier/zapier-sdk-cli@latest — public npm package that provides zapier-sdk, zapier-sdk-cli, and zapier-sdk-experimental. Installed globally.
• Five companion skills installed through the skills CLI: workflows/doctor, workflows/create, workflows/list, workflows/history, and workflows/modify.

What this does not install:

• @zapier/zapier-sdk-code-substrate — old private CLI path. Do not install it for EA.
• @zapier/zapier-durable globally. The create skill installs or pins it inside workflow projects when needed.

Step 1: Probe Environment

Run each check. If any fails, stop and tell the user how to fix it.

node --version
npm --version
git --version

Expected output:

v18.0.0   # or higher
10.x.x    # npm version; any current version is fine
git version 2.x.x