sendcraft-cli 1.0.0 → 1.1.0

package/bin/sendcraft.js

@@ -6,7 +6,6 @@ const { program } = require('commander');
 const chalk = require('chalk');
 const pkg = require('../package.json');
 
-// Sub-commands
 program
   .name('sendcraft')
   .description('Official SendCraft CLI')
@@ -20,17 +19,17 @@ program.addCommand(require('../lib/commands/subscribers'));
 program.addCommand(require('../lib/commands/domains'));
 program.addCommand(require('../lib/commands/keys'));
 program.addCommand(require('../lib/commands/warmup'));
+program.addCommand(require('../lib/commands/mcp'));
 
-// Friendly error on unknown command
 program.on('command:*', (args) => {
-  console.error(chalk.red(`Unknown command: ${args[0]}`));
-  console.error('Run ' + chalk.bold('sendcraft --help') + ' to see available commands.');
+  console.error(chalk.red(`  ✗ Unknown command: ${args[0]}`));
+  console.error('  Run ' + chalk.bold('sendcraft --help') + ' for available commands.');
   process.exit(1);
 });
 
-program.parse(process.argv);
-
-// Show help if called with no args
+// Interactive mode when called with no args
 if (process.argv.length < 3) {
-  program.help();
+  require('../lib/interactive')();
+} else {
+  program.parse(process.argv);
 }

package/lib/banner.js

@@ -0,0 +1,53 @@
+/**
+ * Animated banner shown on `sendcraft` with no args.
+ */
+const figlet = require('figlet');
+const _grad = require('gradient-string'); const gradient = _grad.default || _grad;
+const _boxen = require('boxen'); const boxen = _boxen.default || _boxen;
+const chalk = require('chalk');
+
+const sendcraftGradient = gradient(['#6366f1', '#8b5cf6', '#ec4899']);
+const successGradient   = gradient(['#10b981', '#3b82f6']);
+
+function banner(version) {
+  const text = figlet.textSync('SendCraft', {
+    font: 'Big',
+    horizontalLayout: 'default',
+    verticalLayout: 'default',
+  });
+
+  console.log(sendcraftGradient.multiline(text));
+
+  const box = boxen(
+    `${chalk.bold('SendCraft CLI')}  ${chalk.dim('v' + version)}\n` +
+    `${chalk.dim('Official CLI for the SendCraft email platform')}\n\n` +
+    `${chalk.cyan('sendcraft config init')}  ${chalk.dim('→ Setup your API key')}\n` +
+    `${chalk.cyan('sendcraft send')}         ${chalk.dim('→ Send an email')}\n` +
+    `${chalk.cyan('sendcraft --help')}       ${chalk.dim('→ All commands')}`,
+    {
+      padding: 1,
+      margin: { top: 0, bottom: 1, left: 0, right: 0 },
+      borderStyle: 'round',
+      borderColor: 'magenta',
+    }
+  );
+  console.log(box);
+}
+
+function printSuccess(msg) {
+  console.log(successGradient('  ✓ ') + chalk.bold(msg));
+}
+
+function printError(msg) {
+  console.error(chalk.red('  ✗ ') + msg);
+}
+
+function printInfo(msg) {
+  console.log(chalk.blue('  ℹ ') + msg);
+}
+
+function printWarn(msg) {
+  console.log(chalk.yellow('  ⚠ ') + msg);
+}
+
+module.exports = { banner, printSuccess, printError, printInfo, printWarn, sendcraftGradient, successGradient };

package/lib/commands/campaigns.js

@@ -1,7 +1,7 @@
 const { Command } = require('commander');
-const ora = require('ora');
+const chalk = require('chalk');
 const client = require('../client');
-const { table, json, colorStatus, info, success, error } = require('../output');
+const { table, json, colorStatus, info, success, error, spinner } = require('../output');
 
 const cmd = new Command('campaigns').description('Manage campaigns');
 
@@ -10,26 +10,26 @@ cmd
   .description('List campaigns')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching campaigns…').start();
     try {
       const data = await client.get('/campaigns');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const campaigns = data.campaigns || [];
-      if (!campaigns.length) return info('No campaigns found.');
+      if (!campaigns.length) return info('No campaigns yet. Create one in the dashboard.');
       table(
         ['ID', 'Name', 'Subject', 'Status', 'Recipients', 'Created'],
         campaigns.map(c => [
-          String(c._id).slice(-8),
-          (c.name || '').slice(0, 25),
+          chalk.dim(String(c._id).slice(-8)),
+          chalk.bold((c.name || '').slice(0, 25)),
           (c.subject || '').slice(0, 30),
           colorStatus(c.status),
-          c.recipientCount ?? '—',
-          c.createdAt ? new Date(c.createdAt).toLocaleString() : '—',
+          c.recipientCount != null ? chalk.cyan(String(c.recipientCount)) : '—',
+          c.createdAt ? chalk.dim(new Date(c.createdAt).toLocaleString()) : '—',
         ])
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -38,18 +38,19 @@ cmd
 cmd
   .command('send <campaignId>')
   .description('Send or schedule a campaign')
-  .option('--schedule <isoDate>', 'Schedule for a specific time (ISO 8601)')
+  .option('--schedule <isoDate>', 'Schedule for a specific ISO 8601 datetime')
   .option('--json', 'Output raw JSON')
   .action(async (campaignId, opts) => {
-    const spinner = ora('Sending…').start();
+    const label = opts.schedule ? `Scheduling campaign…` : `Sending campaign…`;
+    const sp = spinner(label).start();
     try {
       const body = opts.schedule ? { scheduledAt: opts.schedule } : {};
       const data = await client.post(`/campaigns/${campaignId}/send`, body);
-      spinner.stop();
+      sp.succeed(chalk.dim('Done'));
       if (opts.json) return json(data);
-      success(`Campaign ${campaignId} ${opts.schedule ? 'scheduled' : 'sent'}!`);
+      success(`Campaign ${opts.schedule ? 'scheduled for ' + chalk.cyan(opts.schedule) : 'sent!'}`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/config.js

@@ -1,8 +1,10 @@
 const { Command } = require('commander');
 const prompts = require('prompts');
 const chalk = require('chalk');
+const ora = require('ora');
 const { load, save, getApiKey, getBaseUrl, CONFIG_FILE } = require('../config');
-const { success, info, error } = require('../output');
+const { success, error, info } = require('../output');
+const { sendcraftGradient } = require('../banner');
 
 const cmd = new Command('config')
   .description('Configure your SendCraft credentials');
@@ -11,20 +13,22 @@ cmd
   .command('set-key <apiKey>')
   .description('Save your API key')
   .action((apiKey) => {
+    const sp = ora({ text: 'Saving…', spinner: 'dots', color: 'cyan' }).start();
     const cfg = load();
     cfg.api_key = apiKey;
     save(cfg);
-    success(`API key saved to ${CONFIG_FILE}`);
+    sp.succeed(chalk.dim('Saved'));
+    success(`API key stored at ${chalk.dim(CONFIG_FILE)}`);
   });
 
 cmd
   .command('set-url <url>')
-  .description('Override the API base URL (default: https://api.sendcraft.online/api)')
+  .description('Override the API base URL')
   .action((url) => {
     const cfg = load();
     cfg.base_url = url;
     save(cfg);
-    success(`Base URL saved: ${url}`);
+    success(`Base URL updated: ${chalk.cyan(url)}`);
   });
 
 cmd
@@ -34,26 +38,28 @@ cmd
     const key = getApiKey();
     const url = getBaseUrl();
     if (!key) {
-      error('No API key set. Run: sendcraft config set-key <key>');
-      info('Or set SENDCRAFT_API_KEY env variable.');
+      error('No API key set. Run: ' + chalk.cyan('sendcraft config set-key <key>'));
+      info('Or set the ' + chalk.bold('SENDCRAFT_API_KEY') + ' environment variable.');
       return;
     }
     const masked = key.length > 12 ? key.slice(0, 8) + '…' + key.slice(-4) : '***';
-    console.log(chalk.bold('API Key:  ') + masked);
-    console.log(chalk.bold('Base URL: ') + url);
-    console.log(chalk.bold('Config:   ') + CONFIG_FILE);
+    console.log('\n' + chalk.bold('  API Key:  ') + chalk.green(masked));
+    console.log(chalk.bold('  Base URL: ') + chalk.cyan(url));
+    console.log(chalk.bold('  Config:   ') + chalk.dim(CONFIG_FILE) + '\n');
   });
 
 cmd
   .command('init')
-  .description('Interactive setup')
+  .description('Interactive first-time setup')
   .action(async () => {
+    console.log('\n' + sendcraftGradient('  ✦ SendCraft Setup\n'));
+
     const answers = await prompts([
       {
         type: 'password',
         name: 'api_key',
-        message: 'Paste your SendCraft API key:',
-        validate: v => v.startsWith('sc_') ? true : 'Key should start with sc_',
+        message: 'Paste your API key',
+        validate: v => (v && v.length > 10) ? true : 'Enter a valid API key',
       },
       {
         type: 'text',
@@ -61,10 +67,12 @@ cmd
         message: 'API base URL',
         initial: 'https://api.sendcraft.online/api',
       },
-    ]);
-    if (!answers.api_key) return error('Cancelled.');
+    ], { onCancel: () => { error('Cancelled.'); process.exit(0); } });
+
+    const sp = ora({ text: 'Saving config…', spinner: 'dots2', color: 'cyan' }).start();
     save(answers);
-    success('Config saved!');
+    sp.succeed(chalk.dim('Config saved'));
+    success(`Ready! Run ${chalk.cyan('sendcraft send --help')} to get started.`);
   });
 
 module.exports = cmd;

package/lib/commands/domains.js

@@ -1,8 +1,8 @@
 const { Command } = require('commander');
-const ora = require('ora');
 const chalk = require('chalk');
+const _grad = require('gradient-string'); const gradient = _grad.default || _grad;
 const client = require('../client');
-const { table, json, colorStatus, info, success, error } = require('../output');
+const { table, json, colorStatus, info, success, error, spinner } = require('../output');
 
 const cmd = new Command('domains').description('Manage sender domains');
 
@@ -11,26 +11,26 @@ cmd
   .description('List all domains')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching domains…').start();
     try {
       const data = await client.get('/domains');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const domains = data.domains || [];
-      if (!domains.length) return info('No domains added yet.');
+      if (!domains.length) return info('No domains added yet. Run: ' + chalk.cyan('sendcraft domains add <domain>'));
       table(
         ['Domain', 'Status', 'SPF', 'DKIM', 'DMARC', 'Added'],
         domains.map(d => [
-          d.domain,
+          chalk.bold(d.domain),
           colorStatus(d.status),
-          d.spfVerified ? chalk.green('✓') : chalk.red('✗'),
+          d.spfVerified  ? chalk.green('✓') : chalk.red('✗'),
           d.dkimVerified ? chalk.green('✓') : chalk.red('✗'),
-          d.dmarcVerified ? chalk.green('✓') : chalk.red('✗'),
-          d.createdAt ? new Date(d.createdAt).toLocaleDateString() : '—',
+          d.dmarcVerified? chalk.green('✓') : chalk.red('✗'),
+          d.createdAt ? chalk.dim(new Date(d.createdAt).toLocaleDateString()) : '—',
         ])
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -41,22 +41,24 @@ cmd
   .description('Add a new sender domain')
   .option('--json', 'Output raw JSON')
   .action(async (domain, opts) => {
-    const spinner = ora('Adding domain…').start();
+    const sp = spinner(`Adding ${chalk.cyan(domain)}…`).start();
     try {
       const data = await client.post('/domains', { domain });
-      spinner.stop();
+      sp.succeed(chalk.dim('Domain added'));
       if (opts.json) return json(data);
-      success(`Domain ${domain} added.`);
-      info('Add these DNS records to your domain:');
+      success(`${chalk.bold(domain)} added.`);
+      console.log('\n' + gradient(['#6366f1', '#ec4899'])('  ─── DNS Records to Configure ───') + '\n');
       (data.dnsRecords || []).forEach(r => {
-        const optional = r.optional ? chalk.gray(' (optional)') : '';
-        console.log(`\n  ${chalk.bold(r.purpose)}${optional}`);
-        console.log(`  Type:  ${r.type}`);
-        console.log(`  Name:  ${r.name}`);
-        console.log(`  Value: ${r.value}`);
+        const verified = r.verified ? chalk.green(' ✓') : '';
+        const optional = r.optional ? chalk.dim(' (optional)') : '';
+        console.log(`  ${chalk.bold.cyan(r.purpose)}${optional}${verified}`);
+        console.log(`    ${chalk.dim('Type:')}  ${r.type}`);
+        console.log(`    ${chalk.dim('Name:')}  ${r.name}`);
+        console.log(`    ${chalk.dim('Value:')} ${chalk.white(r.value)}\n`);
       });
+      info(`Run ${chalk.cyan(`sendcraft domains verify <id>`)} after DNS propagates.`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -67,27 +69,28 @@ cmd
   .description('Trigger a DNS verification check')
   .option('--json', 'Output raw JSON')
   .action(async (id, opts) => {
-    const spinner = ora('Checking DNS…').start();
+    const sp = spinner('Checking DNS records…').start();
     try {
       const data = await client.post(`/domains/${id}/verify`);
-      spinner.stop();
-      if (opts.json) return json(data);
       if (data.verified) {
-        success('All records verified! Domain is ready.');
+        sp.succeed(gradient(['#10b981', '#3b82f6'])('All records verified!'));
       } else {
-        const r = data.results || {};
-        table(
-          ['Record', 'Status'],
-          [
-            ['SPF', r.spf ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-            ['DKIM', r.dkim ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-            ['DMARC', r.dmarc ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-          ]
-        );
-        info(data.message || 'Some records still pending.');
+        sp.warn(chalk.yellow('Some records still pending'));
       }
+      if (opts.json) return json(data);
+      const r = data.results || {};
+      table(
+        ['Record', 'Status'],
+        [
+          ['SPF',   r.spf   ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+          ['DKIM',  r.dkim  ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+          ['DMARC', r.dmarc ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+        ]
+      );
+      if (data.verified) success('Domain is ready to send email!');
+      else info(data.message || 'DNS changes can take up to 48 hours to propagate.');
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -95,24 +98,25 @@ cmd
 
 cmd
   .command('records <domainId>')
-  .description('Show DNS records to configure for a domain')
+  .description('Show DNS records to configure')
   .option('--json', 'Output raw JSON')
   .action(async (id, opts) => {
-    const spinner = ora('Loading…').start();
+    const sp = spinner('Loading DNS records…').start();
     try {
       const data = await client.get(`/domains/${id}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data.dnsRecords);
+      console.log('\n' + gradient(['#6366f1', '#ec4899'])('  ─── DNS Records ───') + '\n');
       (data.dnsRecords || []).forEach(r => {
-        const status = r.verified ? chalk.green('✓ verified') : chalk.yellow('⏳ pending');
-        const optional = r.optional ? chalk.gray(' (optional)') : '';
-        console.log(`\n  ${chalk.bold(r.purpose)} — ${status}${optional}`);
-        console.log(`  Type:  ${r.type}`);
-        console.log(`  Name:  ${r.name}`);
-        console.log(`  Value: ${r.value}`);
+        const status   = r.verified ? chalk.green('✓ verified') : chalk.yellow('⏳ pending');
+        const optional = r.optional ? chalk.dim(' (optional)') : '';
+        console.log(`  ${chalk.bold.cyan(r.purpose)}${optional}  ${status}`);
+        console.log(`    ${chalk.dim('Type:')}  ${r.type}`);
+        console.log(`    ${chalk.dim('Name:')}  ${r.name}`);
+        console.log(`    ${chalk.dim('Value:')} ${chalk.white(r.value)}\n`);
       });
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/emails.js

@@ -1,7 +1,7 @@
 const { Command } = require('commander');
-const ora = require('ora');
+const chalk = require('chalk');
 const client = require('../client');
-const { table, json, colorStatus, info } = require('../output');
+const { table, json, colorStatus, info, error, spinner } = require('../output');
 
 const cmd = new Command('emails').description('Manage emails');
 
@@ -13,29 +13,29 @@ cmd
   .option('--status <s>', 'Filter by status (sent, delivered, failed, scheduled)')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching emails…').start();
     try {
       const params = new URLSearchParams({ page: opts.page, limit: opts.limit });
       if (opts.status) params.set('status', opts.status);
       const data = await client.get(`/emails?${params}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const emails = data.emails || [];
       if (!emails.length) return info('No emails found.');
       table(
         ['ID', 'To', 'Subject', 'Status', 'Sent At'],
         emails.map(e => [
-          String(e._id).slice(-8),
-          e.toEmail,
+          chalk.dim(String(e._id).slice(-8)),
+          chalk.cyan(e.toEmail),
           (e.subject || '').slice(0, 40),
           colorStatus(e.status),
-          e.createdAt ? new Date(e.createdAt).toLocaleString() : '—',
+          e.createdAt ? chalk.dim(new Date(e.createdAt).toLocaleString()) : '—',
         ])
       );
-      info(`Page ${opts.page} · ${emails.length} of ${data.total || '?'}`);
+      info(`Page ${opts.page} · ${emails.length} of ${chalk.bold(data.total ?? '?')}`);
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });
@@ -45,28 +45,32 @@ cmd
   .description('Show email stats summary')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Loading…').start();
+    const sp = spinner('Loading stats…').start();
     try {
       const data = await client.get('/emails/stats/summary');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const s = data.stats || data;
+
+      const openRate  = s.openRate  != null ? chalk.green(`${(s.openRate  * 100).toFixed(1)}%`) : '—';
+      const clickRate = s.clickRate != null ? chalk.cyan( `${(s.clickRate * 100).toFixed(1)}%`) : '—';
+
       table(
         ['Metric', 'Value'],
         [
-          ['Total Sent', s.totalSent ?? '—'],
-          ['Delivered', s.delivered ?? '—'],
-          ['Opened', s.opened ?? '—'],
-          ['Clicked', s.clicked ?? '—'],
-          ['Bounced', s.bounced ?? '—'],
-          ['Failed', s.failed ?? '—'],
-          ['Open Rate', s.openRate != null ? `${(s.openRate * 100).toFixed(1)}%` : '—'],
-          ['Click Rate', s.clickRate != null ? `${(s.clickRate * 100).toFixed(1)}%` : '—'],
+          ['Total Sent',  chalk.bold(String(s.totalSent  ?? '—'))],
+          ['Delivered',   chalk.green(String(s.delivered  ?? '—'))],
+          ['Opened',      chalk.cyan(String(s.opened      ?? '—'))],
+          ['Clicked',     chalk.cyan(String(s.clicked     ?? '—'))],
+          ['Bounced',     chalk.red(String(s.bounced      ?? '—'))],
+          ['Failed',      chalk.red(String(s.failed       ?? '—'))],
+          ['Open Rate',   openRate],
+          ['Click Rate',  clickRate],
         ]
       );
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });
@@ -76,26 +80,26 @@ cmd
   .description('Get details for a single email')
   .option('--json', 'Output raw JSON')
   .action(async (emailId, opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner(`Fetching email ${chalk.dim(emailId.slice(-8))}…`).start();
     try {
       const data = await client.get(`/emails/${emailId}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const e = data.email || data;
       table(
         ['Field', 'Value'],
         [
-          ['ID', e._id],
-          ['To', e.toEmail],
-          ['Subject', e.subject],
-          ['Status', colorStatus(e.status)],
-          ['From', e.fromEmail || '—'],
+          ['ID',      chalk.dim(e._id)],
+          ['To',      chalk.cyan(e.toEmail)],
+          ['Subject', chalk.bold(e.subject)],
+          ['Status',  colorStatus(e.status)],
+          ['From',    e.fromEmail || '—'],
           ['Sent At', e.createdAt ? new Date(e.createdAt).toLocaleString() : '—'],
         ]
       );
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });

package/lib/commands/keys.js

@@ -1,8 +1,8 @@
 const { Command } = require('commander');
-const ora = require('ora');
 const chalk = require('chalk');
+const _grad = require('gradient-string'); const gradient = _grad.default || _grad;
 const client = require('../client');
-const { table, json, info, success, error } = require('../output');
+const { table, json, info, success, error, spinner } = require('../output');
 
 const cmd = new Command('keys').description('Manage API keys');
 
@@ -11,26 +11,26 @@ cmd
   .description('List all API keys')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching API keys…').start();
     try {
       const data = await client.get('/user/keys');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const keys = data.keys || [];
-      if (!keys.length) return info('No API keys found.');
+      if (!keys.length) return info('No API keys. Run: ' + chalk.cyan('sendcraft keys create <name>'));
       table(
-        ['ID', 'Name', 'Key (masked)', 'Permissions', 'Last Used', 'Created'],
+        ['ID', 'Name', 'Key', 'Permissions', 'Last Used', 'Created'],
         keys.map(k => [
-          String(k._id).slice(-8),
-          k.name,
-          k.maskedKey || '***',
-          k.permissions || 'full_access',
-          k.lastUsedAt ? new Date(k.lastUsedAt).toLocaleDateString() : 'Never',
-          k.createdAt ? new Date(k.createdAt).toLocaleDateString() : '—',
+          chalk.dim(String(k._id).slice(-8)),
+          chalk.bold(k.name),
+          chalk.dim(k.maskedKey || '***'),
+          k.permissions === 'full_access' ? chalk.green('full_access') : chalk.yellow('sending_access'),
+          k.lastUsedAt ? chalk.dim(new Date(k.lastUsedAt).toLocaleDateString()) : chalk.dim('Never'),
+          k.createdAt  ? chalk.dim(new Date(k.createdAt).toLocaleDateString())  : '—',
         ])
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -39,11 +39,11 @@ cmd
 cmd
   .command('create <name>')
   .description('Create a new API key')
-  .option('--permissions <type>', 'full_access or sending_access', 'full_access')
-  .option('--domains <domains>', 'Comma-separated allowed sender domains')
+  .option('--permissions <type>', 'full_access (default) or sending_access', 'full_access')
+  .option('--domains <list>', 'Comma-separated allowed sender domains')
   .option('--json', 'Output raw JSON')
   .action(async (name, opts) => {
-    const spinner = ora('Creating…').start();
+    const sp = spinner(`Creating key "${chalk.cyan(name)}"…`).start();
     try {
       const body = {
         name,
@@ -51,18 +51,22 @@ cmd
         allowedDomains: opts.domains ? opts.domains.split(',').map(d => d.trim()) : undefined,
       };
       const data = await client.post('/user/keys', body);
-      spinner.stop();
+      sp.succeed(chalk.dim('Created'));
       if (opts.json) return json(data);
+
       const key = data.key;
-      success('API key created!');
-      console.log(chalk.bold('\nKey (save this — shown only once):'));
-      console.log(chalk.green(key.key || '—'));
-      console.log(`\nPermissions: ${key.permissions}`);
+      console.log('\n' + gradient(['#6366f1', '#10b981'])('  ─── New API Key ───') + '\n');
+      console.log(`  ${chalk.bold('Name:')}        ${chalk.cyan(key.name)}`);
+      console.log(`  ${chalk.bold('Permissions:')} ${key.permissions === 'full_access' ? chalk.green('full_access') : chalk.yellow('sending_access')}`);
       if (key.allowedDomains?.length) {
-        console.log(`Allowed domains: ${key.allowedDomains.join(', ')}`);
+        console.log(`  ${chalk.bold('Domains:')}     ${key.allowedDomains.join(', ')}`);
       }
+      console.log(`\n  ${chalk.bold.yellow('Key (save this — shown once only):')}`);
+      console.log(`  ${chalk.bgBlack.green.bold(' ' + (key.key || '—') + ' ')}\n`);
+
+      success('Store this key securely. It cannot be retrieved again.');
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -70,17 +74,17 @@ cmd
 
 cmd
   .command('revoke <keyId>')
-  .description('Revoke an API key permanently')
+  .description('Permanently revoke an API key')
   .option('--json', 'Output raw JSON')
   .action(async (keyId, opts) => {
-    const spinner = ora('Revoking…').start();
+    const sp = spinner(`Revoking key ${chalk.dim(keyId.slice(-8))}…`).start();
     try {
       const data = await client.delete(`/user/keys/${keyId}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Revoked'));
       if (opts.json) return json(data);
-      success(`Key ${keyId} revoked.`);
+      success(`Key ${chalk.dim(keyId)} permanently revoked.`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }