@mailmodo/cli 0.0.9 → 0.0.10

package/dist/commands/billing/index.js

@@ -35,7 +35,7 @@ export default class Billing extends BaseCommand {
      * opens Stripe Checkout if no card is on file.
      */
     async showStatus(jsonOutput) {
-        const response = await this.apiClient.get(API_ENDPOINTS.BILLING_STATUS);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading billing status...' }, () => this.apiClient.get(API_ENDPOINTS.BILLING_STATUS));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -84,9 +84,9 @@ export default class Billing extends BaseCommand {
      * @param {boolean} jsonOutput - Whether to output JSON instead of formatted text.
      */
     async setCap(cap, jsonOutput) {
-        const response = await this.apiClient.patch(API_ENDPOINTS.BILLING_CAP, {
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Updating spending cap...' }, () => this.apiClient.patch(API_ENDPOINTS.BILLING_CAP, {
             cap,
-        });
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/contacts/index.js

@@ -43,7 +43,7 @@ export default class Contacts extends BaseCommand {
      * Displays aggregate contact counts: total, active, unsubscribed, bounced.
      */
     async showSummary(jsonOutput) {
-        const response = await this.apiClient.get(API_ENDPOINTS.CONTACTS);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading contacts...' }, () => this.apiClient.get(API_ENDPOINTS.CONTACTS));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -62,7 +62,7 @@ export default class Contacts extends BaseCommand {
      * status, properties, and pending emails.
      */
     async searchContact(email, jsonOutput) {
-        const response = await this.apiClient.get(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Looking up contact...' }, () => this.apiClient.get(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`));
         if (!response.ok) {
             if (response.status === 404) {
                 if (jsonOutput) {
@@ -97,7 +97,7 @@ export default class Contacts extends BaseCommand {
      * for the generated file.
      */
     async exportContacts(jsonOutput) {
-        const response = await this.apiClient.get(API_ENDPOINTS.CONTACTS_EXPORT);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Preparing contact export...' }, () => this.apiClient.get(API_ENDPOINTS.CONTACTS_EXPORT));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -126,7 +126,7 @@ export default class Contacts extends BaseCommand {
                 return;
             }
         }
-        const response = await this.apiClient.delete(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Deleting contact...' }, () => this.apiClient.delete(`${API_ENDPOINTS.CONTACTS}/${encodeURIComponent(email)}`));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/deploy/index.d.ts

@@ -6,7 +6,24 @@ export default class Deploy extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    /**
+     * Fetches current DNS verification status for the deploy flow.
+     *
+     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
+     */
+    private fetchDomainVerifyForDeploy;
     run(): Promise<void>;
+    /**
+     * Lists emails about to be deployed (skipped when `--json` is set).
+     *
+     * @param yamlConfig - Loaded project YAML.
+     * @param jsonOutput - When true, skip human-readable output.
+     */
+    private logPreDeploySummary;
+    /**
+     * Prints the post-deploy success message and SDK install snippet for interactive runs.
+     */
+    private logDeploySuccessInstructions;
     /**
      * Interactive domain setup flow. Collects domain, sender email, and business
      * address from the user, then calls the API to get DNS records to configure.

package/dist/commands/deploy/index.js

@@ -12,11 +12,19 @@ export default class Deploy extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
     };
+    /**
+     * Fetches current DNS verification status for the deploy flow.
+     *
+     * @param jsonOutput - When true, spinner uses stderr for stdout-safe JSON runs.
+     */
+    fetchDomainVerifyForDeploy(jsonOutput) {
+        return this.withApiSpinner({ json: jsonOutput, text: '  Checking domain verification...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY));
+    }
     async run() {
         const { flags } = await this.parse(Deploy);
         await this.ensureAuth();
         const yamlConfig = await this.ensureYaml();
-        const domainVerify = await this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY);
+        const domainVerify = await this.fetchDomainVerifyForDeploy(flags.json);
         const domainVerified = domainVerify.ok &&
             domainVerify.data?.spf === 'pass' &&
             domainVerify.data?.dkim === 'pass' &&
@@ -44,14 +52,7 @@ export default class Deploy extends BaseCommand {
             if (!completed)
                 return;
         }
-        if (!flags.json) {
-            this.log(`\n  ${chalk.green('✓')} Domain: ${yamlConfig.project?.domain || 'verified'}\n`);
-            this.log(`  Deploying:`);
-            for (const email of yamlConfig.emails) {
-                this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
-            }
-            this.log('');
-        }
+        this.logPreDeploySummary(yamlConfig, flags.json);
         if (!flags.yes) {
             const proceed = await confirm({
                 default: true,
@@ -62,10 +63,10 @@ export default class Deploy extends BaseCommand {
                 return;
             }
         }
-        const response = await this.apiClient.post(API_ENDPOINTS.SEQUENCES, {
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Deploying email sequences...' }, () => this.apiClient.post(API_ENDPOINTS.SEQUENCES, {
             emails: yamlConfig.emails,
             project: yamlConfig.project,
-        });
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -77,6 +78,28 @@ export default class Deploy extends BaseCommand {
             }, null, 2));
             return;
         }
+        this.logDeploySuccessInstructions();
+    }
+    /**
+     * Lists emails about to be deployed (skipped when `--json` is set).
+     *
+     * @param yamlConfig - Loaded project YAML.
+     * @param jsonOutput - When true, skip human-readable output.
+     */
+    logPreDeploySummary(yamlConfig, jsonOutput) {
+        if (jsonOutput)
+            return;
+        this.log(`\n  ${chalk.green('✓')} Domain: ${yamlConfig.project?.domain || 'verified'}\n`);
+        this.log(`  Deploying:`);
+        for (const email of yamlConfig.emails) {
+            this.log(`  ${chalk.green('+')} ${email.id.padEnd(24)} ${email.trigger}`);
+        }
+        this.log('');
+    }
+    /**
+     * Prints the post-deploy success message and SDK install snippet for interactive runs.
+     */
+    logDeploySuccessInstructions() {
         this.log(`  ${chalk.green('Deployed.')} Emails are live.\n`);
         this.log(`  ${'─'.repeat(53)}`);
         this.log(`  ${chalk.bold('ADD THIS TO YOUR APP (one-time only):')}`);
@@ -125,11 +148,11 @@ export default class Deploy extends BaseCommand {
                 validate: (v) => (v?.trim() ? true : 'Address is required'),
             });
         }
-        const domainResponse = await this.apiClient.post(API_ENDPOINTS.DOMAIN, {
+        const domainResponse = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, {
             address,
             domain,
             fromEmail: senderEmail,
-        });
+        }));
         if (!domainResponse.ok) {
             this.handleApiError(domainResponse);
         }
@@ -171,10 +194,7 @@ export default class Deploy extends BaseCommand {
      * @returns {Promise<boolean>} true if all records pass.
      */
     async verifyDomain(jsonOutput) {
-        if (!jsonOutput) {
-            this.log(`\n  Checking DNS...`);
-        }
-        const verify = await this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY);
+        const verify = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY));
         if (!verify.ok) {
             this.handleApiError(verify);
         }

package/dist/commands/domain/index.js

@@ -72,11 +72,11 @@ export default class Domain extends BaseCommand {
                 validate: (v) => (v?.trim() ? true : 'Address is required'),
             });
         }
-        const response = await this.apiClient.post(API_ENDPOINTS.DOMAIN, {
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Configuring domain...' }, () => this.apiClient.post(API_ENDPOINTS.DOMAIN, {
             address,
             domain,
             fromEmail: senderEmail,
-        });
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -112,10 +112,7 @@ export default class Domain extends BaseCommand {
      * Calls the domain verification API and displays pass/fail for each DNS record.
      */
     async verifyDomain(jsonOutput) {
-        if (!jsonOutput) {
-            this.log(`\n  Checking DNS...`);
-        }
-        const response = await this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Checking DNS...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_VERIFY));
         if (!response.ok) {
             this.handleApiError(response);
         }
@@ -148,7 +145,7 @@ export default class Domain extends BaseCommand {
      * bounce rate, and spam complaint rate.
      */
     async showDomainStatus(jsonOutput) {
-        const response = await this.apiClient.get(API_ENDPOINTS.DOMAIN_STATUS);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Loading domain status...' }, () => this.apiClient.get(API_ENDPOINTS.DOMAIN_STATUS));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/edit/index.js

@@ -39,7 +39,7 @@ export default class Edit extends BaseCommand {
                 validate: (value) => value?.trim() ? true : 'Please describe the change',
             });
         }
-        const response = await this.apiClient.post(API_ENDPOINTS.EDIT, {
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Applying AI edits...' }, () => this.apiClient.post(API_ENDPOINTS.EDIT, {
             changeRequest: changeDescription,
             currentEmail: {
                 condition: email.condition,
@@ -50,7 +50,7 @@ export default class Edit extends BaseCommand {
                 subject: email.subject,
                 trigger: email.trigger,
             },
-        });
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/init/index.js

@@ -12,6 +12,23 @@ function isValidUrl(value) {
         return false;
     }
 }
+/**
+ * Prints the human-readable analysis summary using the provided line writer.
+ * Use stderr when `--json` is set so stdout stays free for machine-readable JSON.
+ *
+ * @param analysis - Parsed analyze API payload.
+ * @param logLine - Line writer (typically bound `this.log` or `this.logToStderr`).
+ */
+function logAnalysisSummary(analysis, logLine) {
+    logLine(`  Detected:`);
+    logLine(`  - Type:    ${analysis.businessType} — ${analysis.description}`);
+    logLine(`  - Model:   ${analysis.pricingModel}`);
+    logLine(`  - Users:   ${analysis.targetUser}`);
+    if (analysis.events?.length) {
+        logLine(`  - Events:  ${analysis.events.join(', ')}`);
+    }
+    logLine('');
+}
 export default class Init extends BaseCommand {
     static description = 'Analyze your product and generate email sequences';
     static examples = [
@@ -38,22 +55,22 @@ export default class Init extends BaseCommand {
                 },
             });
         }
-        this.log(`\n  Analyzing your product...`);
-        this.log(`  Scraping: homepage, pricing, features\n`);
-        const analysisResponse = await this.apiClient.post(API_ENDPOINTS.ANALYZE, { url: productUrl });
+        const analysisResponse = await this.withApiSpinner({
+            json: flags.json,
+            text: '  Analyzing your product — scraping homepage, pricing, features',
+        }, () => this.apiClient.post(API_ENDPOINTS.ANALYZE, {
+            url: productUrl,
+        }));
         if (!analysisResponse.ok) {
             this.handleApiError(analysisResponse);
         }
         const analysis = analysisResponse.data;
-        if (!flags.json) {
-            this.log(`  Detected:`);
-            this.log(`  - Type:    ${analysis.businessType} — ${analysis.description}`);
-            this.log(`  - Model:   ${analysis.pricingModel}`);
-            this.log(`  - Users:   ${analysis.targetUser}`);
-            if (analysis.events?.length) {
-                this.log(`  - Events:  ${analysis.events.join(', ')}`);
-            }
-            this.log('');
+        const shouldShowAnalysisSummary = !flags.json || !flags.yes;
+        if (shouldShowAnalysisSummary) {
+            const logSummary = flags.json && !flags.yes
+                ? this.logToStderr.bind(this)
+                : this.log.bind(this);
+            logAnalysisSummary(analysis, logSummary);
         }
         let analysisPayload = analysis;
         if (!flags.yes) {
@@ -89,12 +106,13 @@ export default class Init extends BaseCommand {
                 analysisPayload = JSON.parse(editedAnalysis);
             }
         }
-        this.log('analysisPayload', analysisPayload);
-        this.log('\n  Generating emails...\n');
-        const generateResponse = await this.apiClient.post(API_ENDPOINTS.GENERATE, {
+        const generateResponse = await this.withApiSpinner({
+            json: flags.json,
+            text: '  Generating email templates...',
+        }, () => this.apiClient.post(API_ENDPOINTS.GENERATE, {
             analysis: analysisPayload,
             productUrl,
-        });
+        }));
         if (!generateResponse.ok) {
             this.handleApiError(generateResponse);
         }

package/dist/commands/login/index.js

@@ -3,7 +3,7 @@ import chalk from 'chalk';
 import open from 'open';
 import { BaseCommand } from '../../lib/base-command.js';
 import { ApiClient } from '../../lib/api-client.js';
-import { saveConfig } from '../../lib/config.js';
+import { loadConfig, saveConfig } from '../../lib/config.js';
 import { API_ENDPOINTS, SIGNUP_URL } from '../../lib/constants.js';
 export default class Login extends BaseCommand {
     static description = 'Authenticate with Mailmodo using your API key';
@@ -16,7 +16,30 @@ export default class Login extends BaseCommand {
     };
     async run() {
         const { flags } = await this.parse(Login);
-        let apiKey = process.env.MAILMODO_API_KEY;
+        const envKey = process.env.MAILMODO_API_KEY;
+        if (!envKey) {
+            const existing = await loadConfig();
+            if (existing?.apiKey) {
+                if (flags.json) {
+                    this.log(JSON.stringify({
+                        accountName: existing.accountName ?? null,
+                        email: existing.email ?? null,
+                        freeRemaining: existing.freeRemaining ?? null,
+                        status: 'already_logged_in',
+                    }, null, 2));
+                    return;
+                }
+                this.log('\n  You are already logged in.\n');
+                const emailDisplay = existing.email?.trim()
+                    ? chalk.green(existing.email.trim())
+                    : chalk.dim('(unknown)');
+                this.log(`  Email: ${emailDisplay}\n`);
+                this.log(`  ${chalk.dim('1.')} Run ${chalk.cyan('mailmodo init')} to generate an email sequence.`);
+                this.log(`  ${chalk.dim('2.')} Run ${chalk.cyan('mailmodo logout')} to log in with another account.\n`);
+                return;
+            }
+        }
+        let apiKey = envKey;
         if (apiKey) {
             this.log('Detected MAILMODO_API_KEY from environment.');
         }
@@ -40,7 +63,7 @@ export default class Login extends BaseCommand {
         }
         const trimmedKey = apiKey.trim();
         const client = new ApiClient(trimmedKey);
-        const response = await client.post(API_ENDPOINTS.AUTH_VALIDATE, {});
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Validating API key...' }, () => client.post(API_ENDPOINTS.AUTH_VALIDATE, {}));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/logout/index.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class Logout extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/logout/index.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { BaseCommand } from '../../lib/base-command.js';
+import { clearConfig, loadConfig } from '../../lib/config.js';
+export default class Logout extends BaseCommand {
+    static description = 'Sign out by removing saved credentials from this machine';
+    static examples = ['<%= config.bin %> logout'];
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(Logout);
+        const config = await loadConfig();
+        if (!config?.apiKey) {
+            if (flags.json) {
+                this.log(JSON.stringify({ status: 'not_logged_in' }, null, 2));
+                return;
+            }
+            this.log('You are not logged in.');
+            return;
+        }
+        await clearConfig();
+        if (flags.json) {
+            this.log(JSON.stringify({ status: 'logged_out' }, null, 2));
+            return;
+        }
+        this.log(`\n  Signed out. Run ${chalk.cyan('mailmodo login')} to authenticate again.\n`);
+    }
+}

package/dist/commands/logs/index.js

@@ -26,7 +26,7 @@ export default class Logs extends BaseCommand {
             params.email = flags.email;
         if (flags.failed)
             params.failed = 'true';
-        const response = await this.apiClient.get(API_ENDPOINTS.LOGS, params);
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Loading email logs...' }, () => this.apiClient.get(API_ENDPOINTS.LOGS, params));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/preview/index.js

@@ -125,9 +125,9 @@ export default class Preview extends BaseCommand {
      */
     async sendTestEmail(emailId, toAddress, jsonOutput) {
         await this.ensureAuth();
-        const response = await this.apiClient.post(`${API_ENDPOINTS.PREVIEW}/${emailId}/send`, {
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Sending test email...' }, () => this.apiClient.post(`${API_ENDPOINTS.PREVIEW}/${emailId}/send`, {
             to: toAddress,
-        });
+        }));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/settings/index.d.ts

@@ -14,6 +14,7 @@ export default class Settings extends BaseCommand {
      * and logoUrl in the project config.
      *
      * @param {import('../../lib/yaml-config.js').MailmodoYaml} yamlConfig - The full YAML config to update and save.
+     * @param {boolean} jsonOutput - When true, spinner uses stderr so stdout stays clean.
      */
     private handleLogoUpload;
 }

package/dist/commands/settings/index.js

@@ -89,7 +89,7 @@ export default class Settings extends BaseCommand {
                     return;
                 }
                 if (editKey === 'logo_file') {
-                    await this.handleLogoUpload(yamlConfig);
+                    await this.handleLogoUpload(yamlConfig, flags.json);
                     return;
                 }
                 if (editKey === 'email_style') {
@@ -122,8 +122,9 @@ export default class Settings extends BaseCommand {
      * and logoUrl in the project config.
      *
      * @param {import('../../lib/yaml-config.js').MailmodoYaml} yamlConfig - The full YAML config to update and save.
+     * @param {boolean} jsonOutput - When true, spinner uses stderr so stdout stays clean.
      */
-    async handleLogoUpload(yamlConfig) {
+    async handleLogoUpload(yamlConfig, jsonOutput) {
         const logoPath = await input({ message: 'Path to logo file:' });
         const resolvedPath = resolve(logoPath);
         if (!existsSync(resolvedPath)) {
@@ -134,7 +135,7 @@ export default class Settings extends BaseCommand {
         const fileBuffer = await readFile(resolvedPath);
         const formData = new FormData();
         formData.append('logo', new Blob([new Uint8Array(fileBuffer)]), logoPath.split(/[/\\]/).pop() || 'logo.png');
-        const response = await this.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData);
+        const response = await this.withApiSpinner({ json: jsonOutput, text: '  Uploading logo...' }, () => this.apiClient.postFormData(API_ENDPOINTS.ASSETS_LOGO, formData));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/commands/status/index.js

@@ -13,7 +13,7 @@ export default class Status extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Status);
         await this.ensureAuth();
-        const response = await this.apiClient.get(API_ENDPOINTS.ANALYTICS);
+        const response = await this.withApiSpinner({ json: flags.json, text: '  Loading analytics...' }, () => this.apiClient.get(API_ENDPOINTS.ANALYTICS));
         if (!response.ok) {
             this.handleApiError(response);
         }

package/dist/lib/base-command.d.ts

@@ -22,6 +22,22 @@ export declare abstract class BaseCommand extends Command {
      * @returns {Promise<MailmodoConfig>} The resolved configuration containing the API key.
      */
     protected ensureAuth(): Promise<MailmodoConfig>;
+    /**
+     * Runs an async function (typically an API call) while showing a cyan ora spinner.
+     * When `options.json` is true, the leading blank line is written to stderr so stdout stays
+     * free for machine-readable JSON (e.g. piping to `jq`).
+     *
+     * @template T - Resolved type of the work promise (often the API client response).
+     * @param {{ json: boolean; text: string }} options - Spinner options.
+     * @param {boolean} options.json - If true, stderr for the blank line before the spinner.
+     * @param {string} options.text - Spinner label (often two leading spaces).
+     * @param {() => Promise<T>} work - Zero-argument async function that performs the request.
+     * @returns {Promise<T>} The fulfilled value from `work`.
+     */
+    protected withApiSpinner<T>(options: {
+        json: boolean;
+        text: string;
+    }, work: () => Promise<T>): Promise<T>;
     /**
      * Loads and returns the mailmodo.yaml configuration from the current directory.
      * Exits with an error if the file is not found, directing the user to run init.

package/dist/lib/base-command.js

@@ -1,5 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
+import ora from 'ora';
 import { ApiClient } from './api-client.js';
 import { loadConfig } from './config.js';
 import { loadYaml } from './yaml-config.js';
@@ -39,6 +40,36 @@ export class BaseCommand extends Command {
         this.apiClient = new ApiClient(config.apiKey);
         return config;
     }
+    /**
+     * Runs an async function (typically an API call) while showing a cyan ora spinner.
+     * When `options.json` is true, the leading blank line is written to stderr so stdout stays
+     * free for machine-readable JSON (e.g. piping to `jq`).
+     *
+     * @template T - Resolved type of the work promise (often the API client response).
+     * @param {{ json: boolean; text: string }} options - Spinner options.
+     * @param {boolean} options.json - If true, stderr for the blank line before the spinner.
+     * @param {string} options.text - Spinner label (often two leading spaces).
+     * @param {() => Promise<T>} work - Zero-argument async function that performs the request.
+     * @returns {Promise<T>} The fulfilled value from `work`.
+     */
+    async withApiSpinner(options, work) {
+        if (options.json) {
+            this.logToStderr('');
+        }
+        else {
+            this.log('');
+        }
+        const spinner = ora({
+            color: 'cyan',
+            text: options.text,
+        }).start();
+        try {
+            return await work();
+        }
+        finally {
+            spinner.stop();
+        }
+    }
     /**
      * Loads and returns the mailmodo.yaml configuration from the current directory.
      * Exits with an error if the file is not found, directing the user to run init.

package/dist/lib/config.d.ts

@@ -22,6 +22,11 @@ export declare function loadConfig(): Promise<MailmodoConfig | null>;
  *   at minimum an apiKey. Optional fields: email, accountName, freeRemaining.
  */
 export declare function saveConfig(config: MailmodoConfig): Promise<void>;
+/**
+ * Deletes the saved CLI config file (~/.mailmodo/config), removing the stored API key.
+ * No-op if the file does not exist.
+ */
+export declare function clearConfig(): Promise<void>;
 /**
  * Returns the absolute path to the Mailmodo config directory (~/.mailmodo).
  *

package/dist/lib/config.js

@@ -1,5 +1,5 @@
 import { existsSync } from 'node:fs';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 const CONFIG_DIR = join(homedir(), '.mailmodo');
@@ -13,7 +13,6 @@ const CONFIG_FILE = join(CONFIG_DIR, 'config');
  *   or null if the config file does not exist or is corrupted.
  */
 export async function loadConfig() {
-    console.log('Loading config from', CONFIG_FILE);
     if (!existsSync(CONFIG_FILE))
         return null;
     try {
@@ -38,6 +37,20 @@ export async function saveConfig(config) {
     }
     await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2));
 }
+/**
+ * Deletes the saved CLI config file (~/.mailmodo/config), removing the stored API key.
+ * No-op if the file does not exist.
+ */
+export async function clearConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return;
+    try {
+        await unlink(CONFIG_FILE);
+    }
+    catch {
+        // Ignore missing file or permission errors; caller can treat as best-effort sign-out.
+    }
+}
 /**
  * Returns the absolute path to the Mailmodo config directory (~/.mailmodo).
  *

package/oclif.manifest.json

@@ -381,6 +381,44 @@
         "index.js"
       ]
     },
+    "logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Sign out by removing saved credentials from this machine",
+      "examples": [
+        "<%= config.bin %> logout"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logout",
+      "pluginAlias": "@mailmodo/cli",
+      "pluginName": "@mailmodo/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logout",
+        "index.js"
+      ]
+    },
     "logs": {
       "aliases": [],
       "args": {},
@@ -435,14 +473,19 @@
         "index.js"
       ]
     },
-    "settings": {
+    "preview": {
       "aliases": [],
-      "args": {},
-      "description": "View and update project settings",
+      "args": {
+        "id": {
+          "description": "Email ID to preview",
+          "name": "id"
+        }
+      },
+      "description": "Preview an email in browser, as text, or send a test",
       "examples": [
-        "<%= config.bin %> settings",
-        "<%= config.bin %> settings --set brand_color=#0F3460",
-        "<%= config.bin %> settings --json"
+        "<%= config.bin %> preview welcome",
+        "<%= config.bin %> preview welcome --text",
+        "<%= config.bin %> preview welcome --send me@example.com"
       ],
       "flags": {
         "json": {
@@ -458,17 +501,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "set": {
-          "description": "Set a setting (format: key=value)",
-          "name": "set",
+        "send": {
+          "description": "Send test email to this address",
+          "name": "send",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "text": {
+          "description": "Output plain text version (for AI agents)",
+          "name": "text",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "settings",
+      "id": "preview",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -478,7 +527,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "settings",
+        "preview",
         "index.js"
       ]
     },
@@ -521,19 +570,14 @@
         "index.js"
       ]
     },
-    "preview": {
+    "settings": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Email ID to preview",
-          "name": "id"
-        }
-      },
-      "description": "Preview an email in browser, as text, or send a test",
+      "args": {},
+      "description": "View and update project settings",
       "examples": [
-        "<%= config.bin %> preview welcome",
-        "<%= config.bin %> preview welcome --text",
-        "<%= config.bin %> preview welcome --send me@example.com"
+        "<%= config.bin %> settings",
+        "<%= config.bin %> settings --set brand_color=#0F3460",
+        "<%= config.bin %> settings --json"
       ],
       "flags": {
         "json": {
@@ -549,23 +593,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "send": {
-          "description": "Send test email to this address",
-          "name": "send",
+        "set": {
+          "description": "Set a setting (format: key=value)",
+          "name": "set",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "text": {
-          "description": "Output plain text version (for AI agents)",
-          "name": "text",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preview",
+      "id": "settings",
       "pluginAlias": "@mailmodo/cli",
       "pluginName": "@mailmodo/cli",
       "pluginType": "core",
@@ -575,10 +613,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "preview",
+        "settings",
         "index.js"
       ]
     }
   },
-  "version": "0.0.9"
+  "version": "0.0.10"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"
@@ -14,7 +14,8 @@
     "@oclif/plugin-plugins": "^5",
     "chalk": "^5.6.2",
     "js-yaml": "^4.1.1",
-    "open": "^11.0.0"
+    "open": "^11.0.0",
+    "ora": "^9.3.0"
   },
   "devDependencies": {
     "@eslint/compat": "^1",