resend-cli 1.8.0 → 1.9.0-preview-automations.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "1.8.0",
+  "version": "1.9.0-preview-automations.0",
   "description": "The official CLI for Resend",
   "license": "MIT",
   "repository": {
@@ -32,7 +32,7 @@
     "commander": "14.0.3",
     "esbuild": "0.27.4",
     "picocolors": "1.1.1",
-    "resend": "6.10.0"
+    "resend": "6.10.0-preview-workflows.4"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.8",
@@ -51,8 +51,6 @@
     "lint:fix": "biome check --write .",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:e2e": "vitest run --config vitest.config.e2e.ts",
-    "sync-skill-version": "node scripts/sync-skill-version.mjs",
-    "version": "pnpm run sync-skill-version && git add skills/resend-cli/SKILL.md"
+    "test:e2e": "vitest run --config vitest.config.e2e.ts"
   }
 }

package/skills/resend-cli/SKILL.md

@@ -3,14 +3,15 @@ name: resend-cli
 description: >
   Operate the Resend platform from the terminal — send emails (including React Email
   .tsx templates via --react-email), manage domains, contacts, broadcasts, templates,
-  webhooks, API keys, and logs via the `resend` CLI. Use when the user wants to run
-  Resend commands in the shell, scripts, or CI/CD pipelines, or send/preview React
-  Email templates. Always load this skill before running `resend` commands — it
-  contains the non-interactive flag contract and gotchas that prevent silent failures.
+  webhooks, API keys, logs, automations, and events via the `resend` CLI. Use when the
+  user wants to run Resend commands in the shell, scripts, or CI/CD pipelines, or
+  send/preview React Email templates. Always load this skill before running `resend`
+  commands — it contains the non-interactive flag contract and gotchas that prevent
+  silent failures.
 license: MIT
 metadata:
   author: resend
-  version: "1.8.0"
+  version: "1.9.0"
   homepage: https://resend.com
   source: https://github.com/resend/resend-cli
 inputs:
@@ -21,6 +22,7 @@ references:
   - references/emails.md
   - references/domains.md
   - references/api-keys.md
+  - references/automations.md
   - references/broadcasts.md
   - references/contacts.md
   - references/contact-properties.md
@@ -36,6 +38,41 @@ references:
 
 # Resend CLI
 
+## Installation
+
+Before running any `resend` commands, check whether the CLI is installed:
+
+```bash
+resend --version
+```
+
+If the command is not found, install it using one of the methods below:
+
+**cURL (macOS / Linux):**
+```bash
+curl -fsSL https://resend.com/install.sh | bash
+```
+
+**Homebrew (macOS / Linux):**
+```bash
+brew install resend/cli/resend
+```
+
+**Node.js:**
+```bash
+npm install -g resend-cli
+```
+
+**PowerShell (Windows):**
+```powershell
+irm https://resend.com/install.ps1 | iex
+```
+
+After installing, verify:
+```bash
+resend --version
+```
+
 ## Agent Protocol
 
 The CLI auto-detects non-TTY environments and outputs JSON — no `--json` flag needed.
@@ -73,6 +110,8 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
 | `domains` | create, verify, update, delete, list |
 | `logs` | list, get, open |
 | `api-keys` | create, list, delete |
+| `automations` | create, get, list, update, delete, open, runs |
+| `events` | create, get, list, update, delete, send, open |
 | `broadcasts` | create, send, update, delete, list |
 | `contacts` | create, update, delete, segments, topics |
 | `contact-properties` | create, update, delete, list |
@@ -143,6 +182,7 @@ resend doctor -q
 - **Defining contact properties** → [references/contact-properties.md](references/contact-properties.md)
 - **Working with templates** → [references/templates.md](references/templates.md)
 - **Viewing API request logs** → [references/logs.md](references/logs.md)
+- **Creating automations or sending events** → [references/automations.md](references/automations.md)
 - **Setting up webhooks or listening for events** → [references/webhooks.md](references/webhooks.md)
 - **Auth, profiles, or health checks** → [references/auth.md](references/auth.md)
 - **Multi-step recipes** (setup, CI/CD, broadcast workflow) → [references/workflows.md](references/workflows.md)

package/skills/resend-cli/references/automations.md

@@ -0,0 +1,166 @@
+# automations & events
+
+Detailed flag specifications for `resend automations` and `resend events` commands.
+
+---
+
+## automations list
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results (1-100) |
+| `--after <cursor>` | string | — | Forward pagination |
+| `--before <cursor>` | string | — | Backward pagination |
+
+---
+
+## automations create
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--name <name>` | string | Yes (unless in `--file`) | Automation name |
+| `--status <status>` | string | No | Initial status: `enabled` or `disabled` |
+| `--steps <json>` | string | Yes (unless `--file`) | Steps array as JSON string |
+| `--edges <json>` | string | Yes (unless `--file`) | Edges array as JSON string |
+| `--file <path>` | string | No | Path to JSON file with full payload (use `"-"` for stdin) |
+
+When using `--file`, the JSON object should contain `{ name, status?, steps, edges }`. Flags override file values.
+
+**Step types:** `trigger`, `delay`, `send_email`, `wait_for_event`, `condition`
+
+**Edge types:** `default`, `condition_met`, `condition_not_met`, `timeout`, `event_received`
+
+---
+
+## automations get
+
+```
+resend automations get <id>
+```
+
+Returns the full automation object including steps and edges.
+
+---
+
+## automations update
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--status <status>` | string | Yes | `enabled` or `disabled` |
+
+```
+resend automations update <id> --status enabled
+```
+
+---
+
+## automations delete
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
+
+---
+
+## automations open
+
+```
+resend automations open [id]
+```
+
+Opens the automations list or a specific automation's editor in the dashboard.
+
+---
+
+## automations runs
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results (1-100) |
+| `--after <cursor>` | string | — | Forward pagination |
+| `--before <cursor>` | string | — | Backward pagination |
+
+```
+resend automations runs <automation-id>
+```
+
+**Run status values:** `running` | `completed` | `failed` | `cancelled`
+
+---
+
+## automations runs get
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--automation-id <id>` | string | Yes | Automation ID |
+| `--run-id <id>` | string | Yes | Run ID |
+
+Returns the full run object including step-level execution details.
+
+---
+
+## events list
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results (1-100) |
+| `--after <cursor>` | string | — | Forward pagination |
+| `--before <cursor>` | string | — | Backward pagination |
+
+---
+
+## events create
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--name <name>` | string | Yes | Event name (e.g. `user.signed_up`) |
+| `--schema <json>` | string | No | JSON object mapping field names to types (`string`, `number`, `boolean`, `date`) |
+
+Event names cannot start with `resend:` (reserved).
+
+---
+
+## events get
+
+```
+resend events get <id-or-name>
+```
+
+Accepts either a UUID or the event name.
+
+---
+
+## events update
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--schema <json>` | string | Yes | Updated schema JSON (pass `null` to clear) |
+
+---
+
+## events delete
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
+
+---
+
+## events send
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--event <name>` | string | Yes | Event name to trigger |
+| `--contact-id <id>` | string | One of `--contact-id` or `--email` | Contact ID |
+| `--email <address>` | string | One of `--contact-id` or `--email` | Contact email |
+| `--payload <json>` | string | No | JSON payload matching the event schema |
+
+---
+
+## events open
+
+```
+resend events open
+```
+
+Opens the events management page in the dashboard.

package/skills/resend-cli/references/workflows.md

@@ -292,7 +292,55 @@ resend contacts topics user@example.com
 
 ---
 
-## 10. CI/CD Integration
+## 10. Automations & Events
+
+```bash
+# 1. Create an event definition (the trigger signal)
+resend events create --name "user.signed_up" --schema '{"plan":"string"}'
+
+# 2. Create an automation triggered by that event
+#    Using a JSON file:
+cat > workflow.json << 'EOF'
+{
+  "name": "Welcome Flow",
+  "steps": [
+    { "ref": "t", "type": "trigger", "config": { "eventName": "user.signed_up" } },
+    { "ref": "d", "type": "delay", "config": { "seconds": 300 } },
+    { "ref": "e", "type": "send_email", "config": { "templateId": "<published-template-id>" } }
+  ],
+  "edges": [
+    { "from": "t", "to": "d", "edgeType": "default" },
+    { "from": "d", "to": "e", "edgeType": "default" }
+  ]
+}
+EOF
+
+resend automations create --file workflow.json
+
+# 3. Enable the automation
+resend automations update <automation-id> --status enabled
+
+# 4. Send an event to trigger it
+resend events send --event "user.signed_up" --email user@example.com --payload '{"plan":"pro"}'
+
+# 5. Check runs
+resend automations runs <automation-id>
+resend automations runs get --automation-id <id> --run-id <id>
+
+# 6. View in dashboard
+resend automations open <automation-id>
+
+# Disable when done
+resend automations update <automation-id> --status disabled
+
+# Clean up
+resend automations delete <automation-id> --yes
+resend events delete <event-id> --yes
+```
+
+---
+
+## 11. CI/CD Integration
 
 ```yaml
 # GitHub Actions example
@@ -332,7 +380,7 @@ resend emails send -q \
 
 ---
 
-## 11. Inbound Email Processing
+## 12. Inbound Email Processing
 
 ```bash
 # Enable receiving on domain (at creation or check existing)