resend-cli 1.2.0 → 1.2.2

package/.github/workflows/release.yml

@@ -3,13 +3,46 @@ on:
   push:
     tags:
       - 'v*'
-permissions:
-  contents: write
 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
@@ -64,12 +97,6 @@ jobs:
             ```pwsh
             irm https://resend.com/install.ps1 | iex
             ```
-
-            **GitHub CLI** _(use while repo is private)_
-            ```sh
-            gh release download --repo resend/resend-cli --pattern "resend-darwin-arm64.tar.gz"
-            tar -xzf resend-darwin-arm64.tar.gz && sudo mv resend /usr/local/bin/ && rm resend-darwin-arm64.tar.gz
-            ```
           files: |
             dist/resend-darwin-arm64.tar.gz
             dist/resend-darwin-x64.tar.gz

package/README.md

@@ -1,6 +1,17 @@
 # Resend CLI
 
-Command-line interface for the [Resend](https://resend.com) email API. Works for humans, AI agents, and CI/CD pipelines.
+The official CLI for [Resend](https://resend.com).
+
+Built for humans, AI agents, and CI/CD pipelines.
+
+```
+██████╗ ███████╗███████╗███████╗███╗   ██╗██████╗
+██╔══██╗██╔════╝██╔════╝██╔════╝████╗  ██║██╔══██╗
+██████╔╝█████╗  ███████╗█████╗  ██╔██╗ ██║██║  ██║
+██╔══██╗██╔══╝  ╚════██║██╔══╝  ██║╚██╗██║██║  ██║
+██║  ██║███████╗███████║███████╗██║ ╚████║██████╔╝
+╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═════╝
+```
 
 ## Install
 

package/biome.json

@@ -31,6 +31,6 @@
     }
   },
   "files": {
-    "includes": ["**", "!**/dist", "!**/bun.lock"]
+    "includes": ["**", "!**/dist", "!**/bun.lock", "!.claude"]
   }
 }

package/bun.lock

@@ -9,7 +9,6 @@
         "@commander-js/extra-typings": "14.0.0",
         "commander": "14.0.3",
         "resend": "6.9.3",
-        "unicode-animations": "1.0.3",
       },
       "devDependencies": {
         "@biomejs/biome": "2.4.6",
@@ -69,8 +68,6 @@
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
 
-    "unicode-animations": ["unicode-animations@1.0.3", "", { "dependencies": { "unicode-animations": "^1.0.1" }, "bin": { "unicode-animations": "scripts/demo.cjs" } }, "sha512-+klB2oWwcYZjYWhwP4Pr8UZffWDFVx6jKeIahE6z0QYyM2dwDeDPyn5nevCYbyotxvtT9lh21cVURO1RX0+YMg=="],
-
     "uuid": ["uuid@10.0.0", "", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ=="],
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "resend-cli",
-  "version": "1.2.0",
-  "description": "Resend CLI — email for developers",
+  "version": "1.2.2",
+  "description": "The official CLI for Resend",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -32,8 +32,7 @@
     "commander": "14.0.3",
     "@commander-js/extra-typings": "14.0.0",
     "resend": "6.9.3",
-    "@clack/prompts": "1.1.0",
-    "unicode-animations": "1.0.3"
+    "@clack/prompts": "1.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.6",

package/src/cli.ts

@@ -15,11 +15,23 @@ import { teamsCommand } from './commands/teams/index';
 import { topicsCommand } from './commands/topics/index';
 import { webhooksCommand } from './commands/webhooks/index';
 import { whoamiCommand } from './commands/whoami';
+import { errorMessage, outputError } from './lib/output';
+import { checkForUpdates } from './lib/update-check';
 import { PACKAGE_NAME, VERSION } from './lib/version';
 
+const BANNER = `
+██████╗ ███████╗███████╗███████╗███╗   ██╗██████╗
+██╔══██╗██╔════╝██╔════╝██╔════╝████╗  ██║██╔══██╗
+██████╔╝█████╗  ███████╗█████╗  ██╔██╗ ██║██║  ██║
+██╔══██╗██╔══╝  ╚════██║██╔══╝  ██║╚██╗██║██║  ██║
+██║  ██║███████╗███████║███████╗██║ ╚████║██████╔╝
+╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═════╝
+`;
+
 const program = new Command()
   .name('resend')
   .description('Resend CLI — email for developers')
+  .addHelpText('beforeAll', BANNER)
   .version(
     `${PACKAGE_NAME} v${VERSION}`,
     '-v, --version',
@@ -50,10 +62,8 @@ Output:
   Errors always exit with code 1: {"error":{"message":"...","code":"..."}}
 
 Examples:
-  $ resend login --key re_123456789
-  $ resend emails send --from you@domain.com --to user@example.com --subject "Hi" --text "Hello"
-  $ resend emails batch --file ./emails.json --json
-  $ resend doctor --json`,
+  $ resend login
+  $ resend emails send`,
   )
   .addCommand(loginCommand)
   .addCommand(logoutCommand)
@@ -71,4 +81,12 @@ Examples:
   .addCommand(openCommand)
   .addCommand(whoamiCommand);
 
-program.parse();
+program
+  .parseAsync()
+  .then(() => checkForUpdates().catch(() => {}))
+  .catch((err) => {
+    outputError({
+      message: errorMessage(err, 'An unexpected error occurred'),
+      code: 'unexpected_error',
+    });
+  });

package/src/commands/auth/login.ts

@@ -133,11 +133,7 @@ export const loginCommand = new Command('login')
       );
     }
 
-    const spinner = createSpinner(
-      'Validating API key...',
-      'braille',
-      globalOpts.quiet,
-    );
+    const spinner = createSpinner('Validating API key...', globalOpts.quiet);
 
     try {
       const resend = new Resend(apiKey);
@@ -190,7 +186,7 @@ export const loginCommand = new Command('login')
         if (choice === '__new__') {
           const newName = await p.text({
             message: 'Enter a name for the new team:',
-            validate: (v) => validateTeamName(v),
+            validate: (v) => validateTeamName(v as string),
           });
           if (p.isCancel(newName)) {
             cancelAndExit('Login cancelled.');
@@ -211,8 +207,14 @@ export const loginCommand = new Command('login')
     if (teamName) {
       try {
         setActiveTeam(teamName);
-      } catch {
-        // Team was just stored, so this should not fail
+      } catch (err) {
+        outputError(
+          {
+            message: errorMessage(err, 'Failed to switch team'),
+            code: 'switch_failed',
+          },
+          { json: globalOpts.json },
+        );
       }
     }
 

package/src/commands/doctor.ts

@@ -1,6 +1,3 @@
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { Command } from '@commander-js/extra-typings';
 import { Resend } from 'resend';
 import type { GlobalOpts } from '../lib/client';
@@ -9,7 +6,8 @@ import { buildHelpText } from '../lib/help-text';
 import { errorMessage, outputResult } from '../lib/output';
 import { createSpinner } from '../lib/spinner';
 import { isInteractive } from '../lib/tty';
-import { PACKAGE_NAME, VERSION } from '../lib/version';
+import { GITHUB_RELEASES_URL } from '../lib/update-check';
+import { VERSION } from '../lib/version';
 
 type CheckStatus = 'pass' | 'warn' | 'fail';
 
@@ -20,21 +18,12 @@ type CheckResult = {
   detail?: string;
 };
 
-const statusIcons: Record<CheckStatus, string> = {
-  pass: '\x1B[32m✔\x1B[0m',
-  warn: '\x1B[33m!\x1B[0m',
-  fail: '\x1B[31m✗\x1B[0m',
-};
-
 async function checkCliVersion(): Promise<CheckResult> {
   try {
-    const encodedName = encodeURIComponent(PACKAGE_NAME);
-    const res = await fetch(
-      `https://registry.npmjs.org/${encodedName}/latest`,
-      {
-        signal: AbortSignal.timeout(5000),
-      },
-    );
+    const res = await fetch(GITHUB_RELEASES_URL, {
+      headers: { Accept: 'application/vnd.github.v3+json' },
+      signal: AbortSignal.timeout(5000),
+    });
     if (!res.ok) {
       return {
         name: 'CLI Version',
@@ -42,8 +31,19 @@ async function checkCliVersion(): Promise<CheckResult> {
         message: `v${VERSION} (could not check for updates)`,
       };
     }
-    const data = (await res.json()) as { version?: string };
-    const latest = data.version ?? 'unknown';
+    const data = (await res.json()) as {
+      tag_name?: string;
+      prerelease?: boolean;
+      draft?: boolean;
+    };
+    if (data.prerelease || data.draft) {
+      return {
+        name: 'CLI Version',
+        status: 'warn',
+        message: `v${VERSION} (could not check for updates)`,
+      };
+    }
+    const latest = data.tag_name?.replace(/^v/, '') ?? 'unknown';
     if (latest === VERSION) {
       return {
         name: 'CLI Version',
@@ -84,8 +84,10 @@ function checkApiKeyPresence(flagValue?: string): CheckResult {
   };
 }
 
-async function checkApiValidationAndDomains(): Promise<CheckResult> {
-  const resolved = resolveApiKey();
+async function checkApiValidationAndDomains(
+  flagValue?: string,
+): Promise<CheckResult> {
+  const resolved = resolveApiKey(flagValue);
   if (!resolved) {
     return {
       name: 'API Validation',
@@ -143,73 +145,8 @@ async function checkApiValidationAndDomains(): Promise<CheckResult> {
   }
 }
 
-function checkAgentDetection(): CheckResult {
-  const home = homedir();
-  const agents: { name: string; found: boolean }[] = [];
-
-  // OpenClaw
-  agents.push({
-    name: 'OpenClaw',
-    found: existsSync(join(home, 'clawd', 'skills')),
-  });
-
-  // Cursor
-  agents.push({ name: 'Cursor', found: existsSync(join(home, '.cursor')) });
-
-  // Claude Desktop
-  const claudeConfigPaths =
-    process.platform === 'darwin'
-      ? [
-          join(
-            home,
-            'Library',
-            'Application Support',
-            'Claude',
-            'claude_desktop_config.json',
-          ),
-        ]
-      : process.platform === 'win32'
-        ? [
-            join(
-              process.env.APPDATA ?? '',
-              'Claude',
-              'claude_desktop_config.json',
-            ),
-          ]
-        : [join(home, '.config', 'Claude', 'claude_desktop_config.json')];
-  agents.push({
-    name: 'Claude Desktop',
-    found: claudeConfigPaths.some(existsSync),
-  });
-
-  // VS Code MCP
-  agents.push({
-    name: 'VS Code',
-    found: existsSync(join(process.cwd(), '.vscode', 'mcp.json')),
-  });
-
-  const detected = agents.filter((a) => a.found);
-
-  if (detected.length === 0) {
-    return {
-      name: 'AI Agents',
-      status: 'pass',
-      message: 'No AI agents detected',
-    };
-  }
-
-  return {
-    name: 'AI Agents',
-    status: 'pass',
-    message: `Detected: ${detected.map((a) => a.name).join(', ')}`,
-    detail: 'Future: run `resend setup <agent>` to configure integration',
-  };
-}
-
 export const doctorCommand = new Command('doctor')
-  .description(
-    'Check CLI version, API key, domain status, and AI agent detection',
-  )
+  .description('Check CLI version, API key, and domain status')
   .addHelpText(
     'after',
     buildHelpText({
@@ -217,9 +154,8 @@ export const doctorCommand = new Command('doctor')
       context: `Checks performed:
   CLI Version    Is the installed version up to date?
   API Key        Is a key present (--api-key, RESEND_API_KEY, or credentials file)?
-  API Validation Is the key valid and accepted by the Resend API?
-  AI Agents      Detected: Claude Desktop, Cursor, VS Code MCP, OpenClaw`,
-      output: `  {\n    "ok": true,\n    "checks": [\n      {"name":"CLI Version","status":"pass","message":"v0.1.0 (latest)"},\n      {"name":"API Key","status":"pass","message":"re_...abcd (source: env)"},\n      {"name":"Domains","status":"pass","message":"1 verified, 0 pending"},\n      {"name":"AI Agents","status":"pass","message":"Detected: Claude Desktop"}\n    ]\n  }\n  status values: "pass" | "warn" | "fail"\n  Exit code 1 if any check has status "fail"`,
+  API Validation Is the key valid and accepted by the Resend API?`,
+      output: `  {\n    "ok": true,\n    "checks": [\n      {"name":"CLI Version","status":"pass","message":"v0.1.0 (latest)"},\n      {"name":"API Key","status":"pass","message":"re_...abcd (source: env)"},\n      {"name":"Domains","status":"pass","message":"1 verified, 0 pending"}\n    ]\n  }\n  status values: "pass" | "warn" | "fail"\n  Exit code 1 if any check has status "fail"`,
       examples: ['resend doctor', 'resend doctor --json'],
     }),
   )
@@ -233,9 +169,7 @@ export const doctorCommand = new Command('doctor')
     }
 
     // Check 1: CLI Version
-    let spinner = interactive
-      ? createSpinner('Checking CLI version...', 'orbit')
-      : null;
+    let spinner = interactive ? createSpinner('Checking CLI version...') : null;
     const versionCheck = await checkCliVersion();
     checks.push(versionCheck);
     if (versionCheck.status === 'warn') {
@@ -245,7 +179,7 @@ export const doctorCommand = new Command('doctor')
     }
 
     // Check 2: API Key
-    spinner = interactive ? createSpinner('Checking API key...', 'scan') : null;
+    spinner = interactive ? createSpinner('Checking API key...') : null;
     const keyCheck = checkApiKeyPresence(globalOpts.apiKey);
     checks.push(keyCheck);
     if (keyCheck.status === 'fail') {
@@ -256,9 +190,9 @@ export const doctorCommand = new Command('doctor')
 
     // Check 3: API Validation + Domains
     spinner = interactive
-      ? createSpinner('Validating API key & domains...', 'scan')
+      ? createSpinner('Validating API key & domains...')
       : null;
-    const domainCheck = await checkApiValidationAndDomains();
+    const domainCheck = await checkApiValidationAndDomains(globalOpts.apiKey);
     checks.push(domainCheck);
     if (domainCheck.status === 'fail') {
       spinner?.fail(domainCheck.message);
@@ -268,26 +202,10 @@ export const doctorCommand = new Command('doctor')
       spinner?.stop(domainCheck.message);
     }
 
-    // Check 4: Agent Detection
-    spinner = interactive
-      ? createSpinner('Detecting AI agents...', 'scan')
-      : null;
-    const agentCheck = checkAgentDetection();
-    checks.push(agentCheck);
-    spinner?.stop(agentCheck.message);
-
     const hasFails = checks.some((c) => c.status === 'fail');
 
     if (!globalOpts.json && isInteractive()) {
       console.log('');
-      for (const check of checks) {
-        const icon = statusIcons[check.status];
-        console.log(`  ${icon} ${check.name}: ${check.message}`);
-        if (check.detail) {
-          console.log(`    ${check.detail}`);
-        }
-      }
-      console.log('');
     } else {
       outputResult({ ok: !hasFails, checks }, { json: globalOpts.json });
     }

package/src/lib/client.ts

@@ -1,6 +1,7 @@
 import { Resend } from 'resend';
 import { resolveApiKey } from './config';
 import { errorMessage, outputError } from './output';
+import { VERSION } from './version';
 
 export type GlobalOpts = {
   apiKey?: string;
@@ -9,6 +10,8 @@ export type GlobalOpts = {
   team?: string;
 };
 
+process.env.RESEND_USER_AGENT = `resend-cli:${VERSION}`;
+
 export function createClient(flagValue?: string, teamName?: string): Resend {
   const resolved = resolveApiKey(flagValue, teamName);
   if (!resolved) {

package/src/lib/config.ts

@@ -203,8 +203,8 @@ export function validateTeamName(name: string): string | undefined {
   if (name.length > 64) {
     return 'Team name must be 64 characters or fewer';
   }
-  if (!/^[a-z0-9_-]+$/.test(name)) {
-    return 'Team name must contain only lowercase letters, numbers, dashes, and underscores';
+  if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+    return 'Team name must contain only letters, numbers, dashes, and underscores';
   }
   return undefined;
 }
@@ -215,4 +215,3 @@ export function maskKey(key: string): string {
   }
   return `${key.slice(0, 3)}...${key.slice(-4)}`;
 }
-

package/src/lib/spinner.ts

@@ -1,4 +1,3 @@
-import spinners from 'unicode-animations';
 import type { GlobalOpts } from './client';
 import { errorMessage, outputError } from './output';
 import { isInteractive, isUnicodeSupported } from './tty';
@@ -9,6 +8,19 @@ const TICK = isUnicodeSupported ? String.fromCodePoint(0x2714) : 'v'; // ✔
 const WARN = isUnicodeSupported ? String.fromCodePoint(0x26a0) : '!'; // ⚠
 const CROSS = isUnicodeSupported ? String.fromCodePoint(0x2717) : 'x'; // ✗
 
+// Braille spinner: cycle through U+2800-block dot patterns.
+const SPINNER_FRAMES = [
+  '\u2839',
+  '\u2838',
+  '\u2834',
+  '\u2826',
+  '\u2807',
+  '\u280F',
+  '\u2819',
+  '\u2839',
+];
+const SPINNER_INTERVAL = 80;
+
 type SdkResponse<T> = { data: T | null; error: { message: string } | null };
 
 /**
@@ -21,7 +33,7 @@ export async function withSpinner<T>(
   errorCode: string,
   globalOpts: GlobalOpts,
 ): Promise<T> {
-  const spinner = createSpinner(messages.loading, 'braille', globalOpts.quiet);
+  const spinner = createSpinner(messages.loading, globalOpts.quiet);
   try {
     const { data, error } = await call();
     if (error) {
@@ -49,13 +61,7 @@ export async function withSpinner<T>(
   }
 }
 
-export type SpinnerName = keyof typeof spinners;
-
-export function createSpinner(
-  message: string,
-  name: SpinnerName = 'braille',
-  quiet?: boolean,
-) {
+export function createSpinner(message: string, quiet?: boolean) {
   if (quiet || !isInteractive()) {
     return {
       update(_msg: string) {},
@@ -65,7 +71,8 @@ export function createSpinner(
     };
   }
 
-  const { frames, interval } = spinners[name];
+  const frames = isUnicodeSupported ? SPINNER_FRAMES : ['-', '\\', '|', '/'];
+  const interval = SPINNER_INTERVAL;
   let i = 0;
   let text = message;