resend-cli 1.2.2 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "description": "The official CLI for Resend",
   "license": "MIT",
   "repository": {
@@ -14,29 +14,48 @@
     "email",
     "api"
   ],
-  "packageManager": "bun@1.3.10",
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@10.11.0",
+  "files": [
+    "dist/cli.cjs"
+  ],
   "type": "module",
   "bin": {
-    "resend": "./src/cli.ts"
+    "resend": "./dist/cli.cjs"
   },
   "scripts": {
-    "dev": "bun run src/cli.ts",
-    "dev:watch": "bun --watch src/cli.ts",
-    "build": "bun build --compile --minify --sourcemap --bytecode src/cli.ts --outfile dist/resend",
+    "dev": "tsx src/cli.ts",
+    "dev:watch": "tsx --watch src/cli.ts",
+    "build": "esbuild src/cli.ts --bundle --platform=node --format=cjs --minify --outfile=dist/cli.cjs",
+    "build:bin": "pnpm build && pkg dist/cli.cjs --compress Brotli --target node24 --output dist/resend",
     "lint": "biome check",
     "format": "biome format --write",
     "typecheck": "tsc --noEmit",
-    "test": "bun test tests/commands tests/lib"
+    "test": "vitest run",
+    "test:e2e": "vitest run --config vitest.config.e2e.ts"
   },
   "dependencies": {
-    "commander": "14.0.3",
+    "@clack/prompts": "1.1.0",
     "@commander-js/extra-typings": "14.0.0",
-    "resend": "6.9.3",
-    "@clack/prompts": "1.1.0"
+    "commander": "14.0.3",
+    "picocolors": "^1.1.1",
+    "resend": "6.9.3"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "@biomejs/biome"
+    ]
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.6",
-    "@types/bun": "1.3.10",
-    "typescript": "5.9.3"
+    "@types/node": "22.19.15",
+    "esbuild": "0.27.3",
+    "tsx": "4.19.4",
+    "typescript": "5.9.3",
+    "vitest": "3.1.4",
+    "@yao-pkg/pkg": "6.14.1"
   }
 }

package/.claude/settings.local.json

@@ -1,5 +0,0 @@
-{
-  "permissions": {
-    "allow": ["Bash(npx biome:*)"]
-  }
-}

package/.github/scripts/pr-title-check.js

@@ -1,34 +0,0 @@
-import fs from 'node:fs';
-
-const eventPath = process.env.GITHUB_EVENT_PATH;
-if (!eventPath) {
-  console.error(
-    'GITHUB_EVENT_PATH is not set. This script must run inside GitHub Actions.',
-  );
-  process.exit(1);
-}
-
-const eventJson = JSON.parse(fs.readFileSync(eventPath, 'utf8'));
-const prTitle = eventJson.pull_request?.title;
-if (!prTitle) {
-  console.error('Could not read pull_request.title from event payload.');
-  process.exit(1);
-}
-
-const isValidType = (title) =>
-  /^(feat|fix|chore|refactor)(\([a-zA-Z0-9-]+\))?:\s[a-z0-9].*$/.test(title);
-
-const validateTitle = (title) => {
-  if (!isValidType(title)) {
-    console.error(
-      `PR title does not follow the required format "[type]: [description]"
-  Examples: "feat: add --cc flag"  |  "fix: domain fetch timeout"
-  Types:    feat · fix · chore · refactor
-  Rules:    lowercase after the colon`,
-    );
-    process.exit(1);
-  }
-  console.info(`PR title valid: "${title}"`);
-};
-
-validateTitle(prTitle);

package/.github/workflows/ci.yml

@@ -1,32 +0,0 @@
-name: CI
-on:
-  push:
-    branches: [main]
-  pull_request:
-concurrency:
-  group: ci-${{ github.ref }}
-  cancel-in-progress: true
-jobs:
-  lint:
-    runs-on: blacksmith-2vcpu-ubuntu-2204
-    steps:
-      - uses: actions/checkout@v6
-      - uses: oven-sh/setup-bun@v2
-      - run: bun install --frozen-lockfile
-      - run: bun run lint
-
-  typecheck:
-    runs-on: blacksmith-2vcpu-ubuntu-2204
-    steps:
-      - uses: actions/checkout@v6
-      - uses: oven-sh/setup-bun@v2
-      - run: bun install --frozen-lockfile
-      - run: bun run typecheck
-
-  test:
-    runs-on: blacksmith-2vcpu-ubuntu-2204
-    steps:
-      - uses: actions/checkout@v6
-      - uses: oven-sh/setup-bun@v2
-      - run: bun install --frozen-lockfile
-      - run: bun run test

package/.github/workflows/pr-title-check.yml

@@ -1,13 +0,0 @@
-name: PR Title Check
-on:
-  pull_request:
-    types: [opened, edited, synchronize, reopened]
-permissions:
-  contents: read
-  pull-requests: read
-jobs:
-  pr-title-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - run: node .github/scripts/pr-title-check.js

package/.github/workflows/release.yml

@@ -1,120 +0,0 @@
-name: Release
-on:
-  push:
-    tags:
-      - 'v*'
-concurrency:
-  group: release
-  cancel-in-progress: false
-jobs:
-  test-binary:
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - os: macos-latest
-            target: bun-darwin-arm64
-            binary: dist/resend
-            flags: "--bytecode"
-          - os: ubuntu-latest
-            target: bun-linux-x64
-            binary: dist/resend
-            flags: "--bytecode"
-          - os: windows-latest
-            target: bun-windows-x64
-            binary: dist/resend.exe
-            flags: ""
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build binary
-        run: bun build --compile --minify --sourcemap ${{ matrix.flags }} src/cli.ts --target=${{ matrix.target }} --outfile ${{ matrix.binary }}
-
-      - name: Verify binary runs
-        run: ${{ matrix.binary }} --version
-
-  release:
-    needs: test-binary
-    permissions:
-      contents: write
-    runs-on: blacksmith-2vcpu-ubuntu-2204
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build binaries
-        run: |
-          bun build --compile --minify --sourcemap --bytecode src/cli.ts --target=bun-darwin-arm64  --outfile dist/resend-darwin-arm64
-          bun build --compile --minify --sourcemap --bytecode src/cli.ts --target=bun-darwin-x64    --outfile dist/resend-darwin-x64
-          bun build --compile --minify --sourcemap --bytecode src/cli.ts --target=bun-linux-x64     --outfile dist/resend-linux-x64
-          bun build --compile --minify --sourcemap --bytecode src/cli.ts --target=bun-linux-arm64   --outfile dist/resend-linux-arm64
-          bun build --compile --minify --sourcemap src/cli.ts --target=bun-windows-x64   --outfile dist/resend-windows-x64.exe
-
-      - name: Verify binaries
-        run: |
-          for f in dist/resend-darwin-arm64 dist/resend-darwin-x64 \
-                    dist/resend-linux-x64 dist/resend-linux-arm64 \
-                    dist/resend-windows-x64.exe; do
-            [ -s "$f" ] || { echo "Missing or empty: $f"; exit 1; }
-          done
-
-      - name: Package archives
-        run: |
-          cd dist
-          for bin in resend-darwin-arm64 resend-darwin-x64 resend-linux-x64 resend-linux-arm64; do
-            cp "$bin" resend
-            chmod +x resend
-            tar -czf "${bin}.tar.gz" resend
-            rm resend
-          done
-          cp resend-windows-x64.exe resend.exe
-          zip resend-windows-x64.zip resend.exe
-          rm resend.exe
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          generate_release_notes: true
-          body: |
-            ## Install
-
-            **macOS / Linux**
-            ```sh
-            curl -fsSL https://resend.com/install.sh | bash
-            ```
-
-            **Windows (PowerShell)**
-            ```pwsh
-            irm https://resend.com/install.ps1 | iex
-            ```
-          files: |
-            dist/resend-darwin-arm64.tar.gz
-            dist/resend-darwin-x64.tar.gz
-            dist/resend-linux-x64.tar.gz
-            dist/resend-linux-arm64.tar.gz
-            dist/resend-windows-x64.zip
-
-  notify-tap:
-    name: Trigger Homebrew Tap Update
-    needs: release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - name: Dispatch publish-release workflow on tap
-        env:
-          GH_TOKEN: ${{ secrets.RELEASE_CLI_ON_HOMEBREW }}
-        run: |
-          gh workflow run publish-release.yml \
-            --repo resend/homebrew-cli \
-            --field version="${GITHUB_REF_NAME}"

package/.github/workflows/test-install-windows.yml

@@ -1,48 +0,0 @@
-name: Test Windows Installer
-
-on:
-  pull_request:
-    paths:
-      - install.ps1
-  workflow_dispatch:
-
-jobs:
-  test:
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Run install.ps1 from repo
-        shell: pwsh
-        run: .\install.ps1
-
-      - name: Verify binary exists
-        shell: pwsh
-        run: |
-          $exe = "$env:USERPROFILE\.resend\bin\resend.exe"
-          if (-not (Test-Path $exe)) {
-            Write-Error "Binary not found at $exe"
-            exit 1
-          }
-          Write-Host "Found binary at $exe"
-
-      - name: Verify binary runs
-        shell: pwsh
-        run: |
-          $exe = "$env:USERPROFILE\.resend\bin\resend.exe"
-          & $exe --version
-          if ($LASTEXITCODE -ne 0) {
-            Write-Error "resend --version failed"
-            exit 1
-          }
-
-      - name: Verify PATH was updated
-        shell: pwsh
-        run: |
-          $binDir = "$env:USERPROFILE\.resend\bin"
-          $path = [Environment]::GetEnvironmentVariable("PATH", "User")
-          if ($path -notlike "*$binDir*") {
-            Write-Error "$binDir was not added to PATH"
-            exit 1
-          }
-          Write-Host "PATH correctly updated"

package/CHANGELOG.md

@@ -1,31 +0,0 @@
-# Changelog
-
-## [0.2.0] - 2026-02-18
-
-### Added
-
-- `resend domains` — create, verify, get, list, update, delete sending domains
-- `resend api-keys` — create, list, delete API keys
-- `resend broadcasts` — full broadcast lifecycle (create, send, get, list, update, delete)
-- `resend contacts` — manage contacts, segments, and topics across all CRUD operations
-- `resend emails batch` — send up to 100 emails in a single request from a JSON file
-- Shared pagination (`--limit`, `--after`, `--before`) on all list commands
-- `--html-file` flag on `emails send` and `broadcasts create` to read body from a file
-
-### Fixed
-
-- `isInteractive()` now checks both `stdin` and `stdout` TTY — CI environments are correctly detected as non-interactive
-- `domains delete` now returns a consistent `{ id, deleted: true }` object instead of an empty `{}`
-
-### Changed
-
-- All delete commands return a uniform `{ object, id, deleted: true }` response
-- `--help` improved across all commands with output shape, error codes, and usage examples
-
----
-
-## [0.1.0] - 2026-02-18
-
-- Initial release: `auth login`, `emails send`, `doctor`
-- Auto JSON output when stdout is not a TTY (`--json`)
-- Cross-platform binaries for macOS, Linux, and Windows via GitHub Actions

package/biome.json

@@ -1,36 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.4.6/schema.json",
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  },
-  "formatter": {
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 80
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single"
-    }
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "correctness": {
-        "noUnusedImports": "error",
-        "noUnusedVariables": "error"
-      },
-      "style": {
-        "useBlockStatements": "error"
-      }
-    }
-  },
-  "files": {
-    "includes": ["**", "!**/dist", "!**/bun.lock", "!.claude"]
-  }
-}

package/bun.lock

@@ -1,73 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 0,
-  "workspaces": {
-    "": {
-      "name": "resend-cli",
-      "dependencies": {
-        "@clack/prompts": "1.1.0",
-        "@commander-js/extra-typings": "14.0.0",
-        "commander": "14.0.3",
-        "resend": "6.9.3",
-      },
-      "devDependencies": {
-        "@biomejs/biome": "2.4.6",
-        "@types/bun": "1.3.10",
-        "typescript": "5.9.3",
-      },
-    },
-  },
-  "packages": {
-    "@biomejs/biome": ["@biomejs/biome@2.4.6", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.4.6", "@biomejs/cli-darwin-x64": "2.4.6", "@biomejs/cli-linux-arm64": "2.4.6", "@biomejs/cli-linux-arm64-musl": "2.4.6", "@biomejs/cli-linux-x64": "2.4.6", "@biomejs/cli-linux-x64-musl": "2.4.6", "@biomejs/cli-win32-arm64": "2.4.6", "@biomejs/cli-win32-x64": "2.4.6" }, "bin": { "biome": "bin/biome" } }, "sha512-QnHe81PMslpy3mnpL8DnO2M4S4ZnYPkjlGCLWBZT/3R9M6b5daArWMMtEfP52/n174RKnwRIf3oT8+wc9ihSfQ=="],
-
-    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.4.6", "", { "os": "darwin", "cpu": "arm64" }, "sha512-NW18GSyxr+8sJIqgoGwVp5Zqm4SALH4b4gftIA0n62PTuBs6G2tHlwNAOj0Vq0KKSs7Sf88VjjmHh0O36EnzrQ=="],
-
-    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.4.6", "", { "os": "darwin", "cpu": "x64" }, "sha512-4uiE/9tuI7cnjtY9b07RgS7gGyYOAfIAGeVJWEfeCnAarOAS7qVmuRyX6d7JTKw28/mt+rUzMasYeZ+0R/U1Mw=="],
-
-    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.4.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-kMLaI7OF5GN1Q8Doymjro1P8rVEoy7BKQALNz6fiR8IC1WKduoNyteBtJlHT7ASIL0Cx2jR6VUOBIbcB1B8pew=="],
-
-    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.4.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-F/JdB7eN22txiTqHM5KhIVt0jVkzZwVYrdTR1O3Y4auBOQcXxHK4dxULf4z43QyZI5tsnQJrRBHZy7wwtL+B3A=="],
-
-    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.4.6", "", { "os": "linux", "cpu": "x64" }, "sha512-oHXmUFEoH8Lql1xfc3QkFLiC1hGR7qedv5eKNlC185or+o4/4HiaU7vYODAH3peRCfsuLr1g6v2fK9dFFOYdyw=="],
-
-    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.4.6", "", { "os": "linux", "cpu": "x64" }, "sha512-C9s98IPDu7DYarjlZNuzJKTjVHN03RUnmHV5htvqsx6vEUXCDSJ59DNwjKVD5XYoSS4N+BYhq3RTBAL8X6svEg=="],
-
-    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.4.6", "", { "os": "win32", "cpu": "arm64" }, "sha512-xzThn87Pf3YrOGTEODFGONmqXpTwUNxovQb72iaUOdcw8sBSY3+3WD8Hm9IhMYLnPi0n32s3L3NWU6+eSjfqFg=="],
-
-    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.4.6", "", { "os": "win32", "cpu": "x64" }, "sha512-7++XhnsPlr1HDbor5amovPjOH6vsrFOCdp93iKXhFn6bcMUI6soodj3WWKfgEO6JosKU1W5n3uky3WW9RlRjTg=="],
-
-    "@clack/core": ["@clack/core@1.1.0", "", { "dependencies": { "sisteransi": "^1.0.5" } }, "sha512-SVcm4Dqm2ukn64/8Gub2wnlA5nS2iWJyCkdNHcvNHPIeBTGojpdJ+9cZKwLfmqy7irD4N5qLteSilJlE0WLAtA=="],
-
-    "@clack/prompts": ["@clack/prompts@1.1.0", "", { "dependencies": { "@clack/core": "1.1.0", "sisteransi": "^1.0.5" } }, "sha512-pkqbPGtohJAvm4Dphs2M8xE29ggupihHdy1x84HNojZuMtFsHiUlRvqD24tM2+XmI+61LlfNceM3Wr7U5QES5g=="],
-
-    "@commander-js/extra-typings": ["@commander-js/extra-typings@14.0.0", "", { "peerDependencies": { "commander": "~14.0.0" } }, "sha512-hIn0ncNaJRLkZrxBIp5AsW/eXEHNKYQBh0aPdoUqNgD+Io3NIykQqpKFyKcuasZhicGaEZJX/JBSIkZ4e5x8Dg=="],
-
-    "@stablelib/base64": ["@stablelib/base64@1.0.1", "", {}, "sha512-1bnPQqSxSuc3Ii6MhBysoWCg58j97aUjuCSZrGSmDxNqtytIi0k8utUenAwTZN4V5mXXYGsVUI9zeBqy+jBOSQ=="],
-
-    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
-
-    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
-
-    "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
-
-    "commander": ["commander@14.0.3", "", {}, "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw=="],
-
-    "fast-sha256": ["fast-sha256@1.3.0", "", {}, "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ=="],
-
-    "postal-mime": ["postal-mime@2.7.3", "", {}, "sha512-MjhXadAJaWgYzevi46+3kLak8y6gbg0ku14O1gO/LNOuay8dO+1PtcSGvAdgDR0DoIsSaiIA8y/Ddw6MnrO0Tw=="],
-
-    "resend": ["resend@6.9.3", "", { "dependencies": { "postal-mime": "2.7.3", "svix": "1.84.1" }, "peerDependencies": { "@react-email/render": "*" }, "optionalPeers": ["@react-email/render"] }, "sha512-GRXjH9XZBJA+daH7bBVDuTShr22iWCxXA8P7t495G4dM/RC+d+3gHBK/6bz9K6Vpcq11zRQKmD+B+jECwQlyGQ=="],
-
-    "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="],
-
-    "standardwebhooks": ["standardwebhooks@1.0.0", "", { "dependencies": { "@stablelib/base64": "^1.0.0", "fast-sha256": "^1.3.0" } }, "sha512-BbHGOQK9olHPMvQNHWul6MYlrRTAOKn03rOe4A8O3CLWhNf4YHBqq2HJKKC+sfqpxiBY52pNeesD6jIiLDz8jg=="],
-
-    "svix": ["svix@1.84.1", "", { "dependencies": { "standardwebhooks": "1.0.0", "uuid": "^10.0.0" } }, "sha512-K8DPPSZaW/XqXiz1kEyzSHYgmGLnhB43nQCMeKjWGCUpLIpAMMM8kx3rVVOSm6Bo6EHyK1RQLPT4R06skM/MlQ=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-
-    "uuid": ["uuid@10.0.0", "", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ=="],
-  }
-}

package/bunfig.toml

@@ -1,2 +0,0 @@
-[install]
-peer = false

package/docs/agent-dx-gaps.md

@@ -1,167 +0,0 @@
-# Agent DX Gap Analysis
-
-Gap analysis of the Resend CLI against the 7 dimensions from
-["You Need to Rewrite Your CLI for AI Agents"](https://justinpoehnelt.com/rewrite-your-cli-for-agents/)
-by Justin Poehnelt (Google).
-
----
-
-## 1. Structured Output
-
-> Agents need machine-readable output — JSON by default when piped.
-
-### Strengths
-
-- **Auto-JSON when piped.** `shouldOutputJson()` returns `true` when `!process.stdout.isTTY` (`src/lib/output.ts:14`). Every command goes through `outputResult` / `outputError`, so piped output is always JSON with zero flags required.
-- **Consistent error envelope.** `outputError` emits `{"error":{"message":"…","code":"…"}}` with exit code 1 (`src/lib/output.ts:35-54`).
-- **Help text documents the JSON shape.** `buildHelpText` includes an `output` section and `errorCodes` list (`src/lib/help-text.ts:1-34`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| No `--output` format flag | Only `--json` exists. No `--output=yaml`, `--output=csv`, or `--output=table`. | Low priority — JSON is sufficient for agents. Consider adding `--output` only if human table formatting is needed. |
-| No JSON-Lines streaming | List endpoints return a single JSON blob. For large result sets an agent can't stream-process rows. | Add optional `--jsonl` or newline-delimited mode to `runList`. |
-
----
-
-## 2. Deterministic, Non-Interactive Behavior
-
-> When piped, CLIs must never prompt — they should fail fast with an actionable error.
-
-### Strengths
-
-- **TTY detection is solid.** `isInteractive()` checks `stdin.isTTY`, `stdout.isTTY`, `CI`, `GITHUB_ACTIONS`, and `TERM=dumb` (`src/lib/tty.ts:1-15`).
-- **Missing flags → structured error.** `promptForMissing` exits with `missing_flags` code and lists which flags are needed (`src/lib/prompts.ts:55-61`).
-- **Delete confirmation → structured error.** `confirmDelete` exits with `confirmation_required` and tells the agent to pass `--yes` (`src/lib/prompts.ts:28-36`).
-- **Spinner is a no-op.** `createSpinner` returns stub methods in non-interactive mode (`src/lib/spinner.ts:48-55`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| `setup` command has no non-interactive default | Bare `resend setup` errors with `missing_target` when piped — the agent must already know the valid targets (`src/commands/setup/index.ts:70-79`). | Consider an `--all` flag or `resend setup --target cursor,vscode` to let agents configure multiple targets in one call. |
-| `skills install` shells out to `npx skills` in TTY | Interactive path delegates to an external process (`src/commands/skills/install.ts:231-246`). If TTY detection is wrong, the agent gets an interactive subprocess. | The non-interactive path already exists and works — just ensure the interactive branch can never trigger when `--json` is passed (currently it can't, but worth a guard). |
-
----
-
-## 3. Meaningful Exit Codes
-
-> Agents rely on exit codes to branch logic. 0 = success, non-zero = specific failure category.
-
-### Strengths
-
-- **Errors exit 1.** `outputError` defaults to exit code 1 (`src/lib/output.ts:39`).
-- **Error codes in JSON.** The `code` field (`missing_flags`, `auth_error`, `fetch_error`, etc.) lets agents distinguish failure types without parsing messages.
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| Single exit code for all errors | Everything exits 1. Auth failures, validation errors, network errors, and 404s are indistinguishable by exit code alone. | Define a small set of exit codes: `1` = general, `2` = usage/validation, `3` = auth, `4` = network/API, `78` = config. Map `outputError` codes to exit codes. |
-| `process.exit(0)` on cancel | `cancelAndExit` exits 0 (`src/lib/prompts.ts:14-17`). A cancelled operation should exit non-zero so agents don't interpret it as success. | Exit 130 (standard SIGINT convention) or a dedicated code on cancellation. |
-
----
-
-## 4. Stderr vs Stdout Separation
-
-> Machines read stdout. Humans read stderr. Progress, spinners, and status go to stderr.
-
-### Strengths
-
-- **Spinners write to stderr.** All spinner output uses `process.stderr.write` (`src/lib/spinner.ts:62-80`).
-- **Error JSON goes to stderr.** `outputError` uses `console.error` for JSON errors (`src/lib/output.ts:42`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| Interactive success messages go to stdout | `console.log(config.successMsg)` in `runDelete`, `runWrite`, and setup commands writes human text to stdout (`src/lib/actions.ts:67,124`). If an agent accidentally gets the interactive branch, it mixes human text with machine output. | Route all non-JSON human messages through `console.error` (stderr) so stdout is always machine-parseable. |
-| `skills install` interactive output on stdout | `console.log('  ✔ ...')` in `installSkills` goes to stdout (`src/commands/skills/install.ts:173-178`). | Move to stderr. |
-
----
-
-## 5. Discoverability & Self-Documentation
-
-> Agents need to understand what a CLI can do from the CLI itself — not from docs websites.
-
-### Strengths
-
-- **Rich help text.** `buildHelpText` adds output shape, error codes, and examples to every command (`src/lib/help-text.ts`).
-- **Examples are runnable.** Help text examples use real `$ resend ...` invocations.
-- **MCP setup exists.** `resend setup` configures the CLI as an MCP server for 5 agents (`src/commands/setup/index.ts`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| No machine-readable command tree | `--help` outputs human-formatted text. There's no `resend --help --json` or `resend commands --json` that returns a structured list of all commands, flags, and types. | Add a hidden `resend commands` (or `--help --json`) that outputs the full command tree as JSON — subcommands, flags, types, defaults, required/optional. This is the single highest-impact improvement for agent discoverability. |
-| No schema per command | Agents guess at flag types and constraints. | Emit JSON Schema for each command's input (flags + args) and output shape. Could be auto-generated from Commander metadata. |
-| No version/capability negotiation | No `resend capabilities` or feature flags. An agent can't check if a subcommand exists without running it. | Add `resend capabilities --json` returning supported commands and API version. |
-
----
-
-## 6. Auth & Configuration
-
-> Agents need non-interactive auth: env vars, config files, or flags — never browser OAuth flows.
-
-### Strengths
-
-- **Three-tier key resolution.** `resolveApiKey` checks `--api-key` flag → `RESEND_API_KEY` env → `~/.config/resend/credentials.json` (`src/lib/config.ts:24-45`). All three work without interaction.
-- **Config file is secure.** Written with `0o600` permissions (`src/lib/config.ts:52-59`).
-- **XDG-compliant.** Respects `XDG_CONFIG_HOME` and `APPDATA` (`src/lib/config.ts:14-22`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| No auth status command | There's no way to verify auth works without making an API call. | Add `resend auth status --json` → `{"authenticated":true,"source":"env","key_prefix":"re_..."}`. Useful for agents to pre-flight check credentials. |
-| No key scoping info | The CLI doesn't surface whether the key is a full-access or sending-only key. | Return key metadata (permissions, team) from a status endpoint if the API supports it. |
-| `resend login` is interactive-only | If `resend login` exists and requires TTY input, agents can't use it. | Ensure `resend login --api-key <key>` works non-interactively (just stores the key). |
-
----
-
-## 7. Idempotency & Safety
-
-> Agent retries are inevitable. Commands should be safe to re-run.
-
-### Strengths
-
-- **Setup commands are idempotent.** `mergeJsonConfig` reads existing config and merges — running twice produces the same result (`src/commands/setup/utils.ts:14-33`). Help text documents this.
-- **Skills install is idempotent.** Files are overwritten with the same content.
-- **Delete requires `--yes`.** Prevents accidental destructive actions in non-interactive mode (`src/lib/prompts.ts:28-36`).
-
-### Gaps
-
-| Gap | Details | Recommendation |
-|-----|---------|----------------|
-| No idempotency keys for create operations | `resend emails send` or `resend domains create` with the same args may create duplicates. | Support `--idempotency-key <key>` passed through to the API's `Idempotency-Key` header. Critical for agent retry loops. |
-| No dry-run mode | No `--dry-run` flag to preview what a command would do. | Add `--dry-run` that validates inputs, resolves auth, and returns the request that *would* be made — without executing it. |
-| File reads have no path validation | `readFile` in `src/lib/files.ts` reads any path the process can access. An agent could be tricked into reading sensitive files. | Validate paths against an allowlist or working-directory scope. Low priority if the CLI is always invoked by a trusted agent. |
-
----
-
-## Implementation Priority
-
-Ordered by impact on agent usability:
-
-| # | Item | Dimension | Effort |
-|---|------|-----------|--------|
-| 1 | `resend commands --json` — machine-readable command tree | Discoverability | Medium |
-| 2 | Differentiated exit codes (2/3/4 by error category) | Exit Codes | Small |
-| 3 | Route all human messages to stderr | Stderr/Stdout | Small |
-| 4 | `resend auth status --json` | Auth | Small |
-| 5 | `--idempotency-key` flag for create/send commands | Idempotency | Small |
-| 6 | `--dry-run` flag | Idempotency | Medium |
-| 7 | JSON Schema per command (input + output) | Discoverability | Large |
-| 8 | `resend capabilities --json` | Discoverability | Medium |
-| 9 | Cancel exits non-zero (130) | Exit Codes | Tiny |
-| 10 | `--jsonl` streaming for list commands | Structured Output | Medium |
-
----
-
-## Summary
-
-The Resend CLI already handles the two most common agent pitfalls well: **structured output is automatic when piped**, and **interactive prompts fail fast with actionable errors**. The spinner, auth, and setup systems are agent-friendly out of the box.
-
-The biggest gaps are in **discoverability** (no way for an agent to introspect available commands as JSON) and **exit code granularity** (everything is exit 1). Fixing items 1-4 above would cover ~80% of the agent DX surface with relatively small changes.