@agent-analytics/cli 0.1.9 → 0.1.11

package/bin/cli.mjs

@@ -18,6 +18,13 @@
  *   npx @agent-analytics/cli init <name>          — Alias for create
  *   npx @agent-analytics/cli delete <id>          — Delete a project
  *   npx @agent-analytics/cli revoke-key           — Revoke and regenerate API key
+ *   npx @agent-analytics/cli experiments list <project>   — List experiments
+ *   npx @agent-analytics/cli experiments create <p> ...  — Create experiment
+ *   npx @agent-analytics/cli experiments get <id>        — Get experiment with results
+ *   npx @agent-analytics/cli experiments pause <id>      — Pause experiment
+ *   npx @agent-analytics/cli experiments resume <id>     — Resume experiment
+ *   npx @agent-analytics/cli experiments complete <id>   — Complete experiment
+ *   npx @agent-analytics/cli experiments delete <id>     — Delete experiment
  *   npx @agent-analytics/cli delete-account       — Delete your account (opens dashboard)
  *   npx @agent-analytics/cli whoami               — Show current account
  */
@@ -47,6 +54,22 @@ function requireKey() {
   return new AgentAnalyticsAPI(key, getBaseUrl());
 }
 
+function withApi(fn) {
+  return async (...args) => {
+    const api = requireKey();
+    try {
+      return await fn(api, ...args);
+    } catch (err) {
+      error(err.message);
+    }
+  };
+}
+
+function ifEmpty(arr, label) {
+  if (!arr || arr.length === 0) { log(`  No ${label} found.`); return true; }
+  return false;
+}
+
 // ==================== COMMANDS ====================
 
 async function cmdLogin(token) {
@@ -82,343 +105,257 @@ async function cmdLogin(token) {
   }
 }
 
-async function cmdCreate(name, domain) {
+const cmdCreate = withApi(async (api, name, domain) => {
   if (!name) error('Usage: npx @agent-analytics/cli create <project-name> --domain https://mysite.com');
   if (!domain) error('Usage: npx @agent-analytics/cli create <project-name> --domain https://mysite.com\n\nThe domain is required so we can restrict tracking to your site.');
 
-  const api = requireKey();
-
   heading(`Creating project: ${name}`);
 
-  try {
-    const data = await api.createProject(name, domain);
-
-    success(data.existing
-      ? `Found existing project for ${BOLD}${domain}${RESET}!\n`
-      : `Project created for ${BOLD}${domain}${RESET}!\n`);
+  const data = await api.createProject(name, domain);
 
-    heading('1. Add this snippet to your site:');
-    log(`${CYAN}${data.snippet}${RESET}\n`);
+  success(data.existing
+    ? `Found existing project for ${BOLD}${domain}${RESET}!\n`
+    : `Project created for ${BOLD}${domain}${RESET}!\n`);
 
-    heading('2. Your agent queries stats with:');
-    log(`${CYAN}${data.api_example}${RESET}\n`);
+  heading('1. Add this snippet to your site:');
+  log(`${CYAN}${data.snippet}${RESET}\n`);
 
-    heading('Project token (for the snippet):');
-    log(`${YELLOW}${data.project_token}${RESET}\n`);
+  heading('2. Your agent queries stats with:');
+  log(`${CYAN}${data.api_example}${RESET}\n`);
 
-  } catch (err) {
-    error(`Failed to create project: ${err.message}`);
-  }
-}
+  heading('Project token (for the snippet):');
+  log(`${YELLOW}${data.project_token}${RESET}\n`);
+});
 
-async function cmdProjects() {
-  const api = requireKey();
+const cmdProjects = withApi(async (api) => {
+  const data = await api.listProjects();
+  const projects = data.projects;
 
-  try {
-    const data = await api.listProjects();
-    const projects = data.projects;
+  if (!projects || projects.length === 0) {
+    log('No projects yet. Create one:');
+    log(`  ${CYAN}npx @agent-analytics/cli create my-site${RESET}`);
+    return;
+  }
 
-    if (!projects || projects.length === 0) {
-      log('No projects yet. Create one:');
-      log(`  ${CYAN}npx @agent-analytics/cli create my-site${RESET}`);
-      return;
-    }
+  heading(`Your Projects (${projects.length})`);
+  log('');
 
-    heading(`Your Projects (${projects.length})`);
+  for (const p of projects) {
+    const created = new Date(p.created_at).toLocaleDateString();
+    log(`  ${BOLD}${p.name}${RESET}  ${DIM}created ${created}${RESET}`);
+    log(`  ${DIM}token:${RESET} ${p.project_token}`);
+    log(`  ${DIM}origins:${RESET} ${p.allowed_origins || '*'}`);
     log('');
-
-    for (const p of projects) {
-      const created = new Date(p.created_at).toLocaleDateString();
-      log(`  ${BOLD}${p.name}${RESET}  ${DIM}created ${created}${RESET}`);
-      log(`  ${DIM}token:${RESET} ${p.project_token}`);
-      log(`  ${DIM}origins:${RESET} ${p.allowed_origins || '*'}`);
-      log('');
-    }
-  } catch (err) {
-    error(`Failed to list projects: ${err.message}`);
   }
-}
+});
 
-async function cmdStats(project, days = 7) {
+const cmdStats = withApi(async (api, project, days = 7) => {
   if (!project) error('Usage: npx @agent-analytics/cli stats <project-name> [--days N]');
 
-  const api = requireKey();
+  const result = await api.getStats(project, days, { returnHeaders: true });
+  const data = result.data;
+  const headers = result.headers;
 
-  try {
-    const result = await api.getStats(project, days, { returnHeaders: true });
-    const data = result.data;
-    const headers = result.headers;
-
-    heading(`Stats: ${project} (last ${days} days)`);
-    log('');
-
-    if (data.totals) {
-      log(`  ${BOLD}Total events:${RESET}   ${data.totals.total_events || 0}`);
-      log(`  ${BOLD}Unique users:${RESET}   ${data.totals.unique_users || 0}`);
-    }
+  heading(`Stats: ${project} (last ${days} days)`);
+  log('');
 
-    if (data.events && data.events.length > 0) {
-      log('');
-      heading('Events:');
-      for (const e of data.events) {
-        log(`  ${e.event}  ${DIM}→${RESET}  ${BOLD}${e.count}${RESET}  ${DIM}(${e.unique_users} users)${RESET}`);
-      }
-    }
+  if (data.totals) {
+    log(`  ${BOLD}Total events:${RESET}   ${data.totals.total_events || 0}`);
+    log(`  ${BOLD}Unique users:${RESET}   ${data.totals.unique_users || 0}`);
+  }
 
-    if (data.daily && data.daily.length > 0) {
-      log('');
-      heading('Daily:');
-      for (const d of data.daily) {
-        const bar = '█'.repeat(Math.min(Math.ceil(d.total_events / 5), 40));
-        log(`  ${d.date}  ${GREEN}${bar}${RESET}  ${d.total_events} events`);
-      }
+  if (data.events && data.events.length > 0) {
+    log('');
+    heading('Events:');
+    for (const e of data.events) {
+      log(`  ${e.event}  ${DIM}→${RESET}  ${BOLD}${e.count}${RESET}  ${DIM}(${e.unique_users} users)${RESET}`);
     }
+  }
 
-    // Monthly usage summary from response headers
-    const monthlyUsage = headers['x-monthly-usage'];
-    if (monthlyUsage) {
-      const events = parseInt(monthlyUsage, 10);
-      const bill = (events / 1000) * 2;
-      const monthlyLimit = headers['x-monthly-limit'];
-      const pct = headers['x-monthly-usage-percent'];
-      log('');
-      if (monthlyLimit && pct) {
-        const capDollars = (parseInt(monthlyLimit, 10) / 1000) * 2;
-        log(`  ${DIM}Monthly usage:${RESET} ${events.toLocaleString()} events ($${bill.toFixed(2)}) — ${pct}% of $${capDollars.toFixed(2)} cap`);
-      } else {
-        log(`  ${DIM}Monthly usage:${RESET} ${events.toLocaleString()} events ($${bill.toFixed(2)})`);
-      }
+  if (data.daily && data.daily.length > 0) {
+    log('');
+    heading('Daily:');
+    for (const d of data.daily) {
+      const bar = '█'.repeat(Math.min(Math.ceil(d.total_events / 5), 40));
+      log(`  ${d.date}  ${GREEN}${bar}${RESET}  ${d.total_events} events`);
     }
+  }
 
+  // Monthly usage summary from response headers
+  const monthlyUsage = headers['x-monthly-usage'];
+  if (monthlyUsage) {
+    const events = parseInt(monthlyUsage, 10);
+    const bill = (events / 1000) * 2;
+    const monthlyLimit = headers['x-monthly-limit'];
+    const pct = headers['x-monthly-usage-percent'];
     log('');
-  } catch (err) {
-    error(`Failed to get stats: ${err.message}`);
+    if (monthlyLimit && pct) {
+      const capDollars = (parseInt(monthlyLimit, 10) / 1000) * 2;
+      log(`  ${DIM}Monthly usage:${RESET} ${events.toLocaleString()} events ($${bill.toFixed(2)}) — ${pct}% of $${capDollars.toFixed(2)} cap`);
+    } else {
+      log(`  ${DIM}Monthly usage:${RESET} ${events.toLocaleString()} events ($${bill.toFixed(2)})`);
+    }
   }
-}
 
-async function cmdEvents(project, opts = {}) {
-  if (!project) error('Usage: npx @agent-analytics/cli events <project-name> [--days N] [--limit N]');
+  log('');
+});
 
-  const api = requireKey();
+const cmdEvents = withApi(async (api, project, opts = {}) => {
+  if (!project) error('Usage: npx @agent-analytics/cli events <project-name> [--days N] [--limit N]');
 
-  try {
-    const data = await api.getEvents(project, opts);
+  const data = await api.getEvents(project, opts);
 
-    heading(`Events: ${project}`);
-    log('');
+  heading(`Events: ${project}`);
+  log('');
 
-    if (!data.events || data.events.length === 0) {
-      log('  No events yet.');
-      return;
-    }
+  if (ifEmpty(data.events, 'events')) return;
 
-    for (const e of data.events) {
-      const time = new Date(e.timestamp).toLocaleString();
-      log(`  ${DIM}${time}${RESET}  ${BOLD}${e.event}${RESET}  ${DIM}${e.user_id || ''}${RESET}`);
-      if (e.properties) {
-        log(`    ${DIM}${JSON.stringify(e.properties)}${RESET}`);
-      }
+  for (const e of data.events) {
+    const time = new Date(e.timestamp).toLocaleString();
+    log(`  ${DIM}${time}${RESET}  ${BOLD}${e.event}${RESET}  ${DIM}${e.user_id || ''}${RESET}`);
+    if (e.properties) {
+      log(`    ${DIM}${JSON.stringify(e.properties)}${RESET}`);
     }
-    log('');
-  } catch (err) {
-    error(`Failed to get events: ${err.message}`);
   }
-}
+  log('');
+});
 
-async function cmdPropertiesReceived(project, opts = {}) {
+const cmdPropertiesReceived = withApi(async (api, project, opts = {}) => {
   if (!project) error('Usage: npx @agent-analytics/cli properties-received <project-name> [--since DATE] [--sample N]');
 
-  const api = requireKey();
+  const data = await api.getPropertiesReceived(project, opts);
 
-  try {
-    const data = await api.getPropertiesReceived(project, opts);
-
-    heading(`Received Properties: ${project}`);
-    log('');
+  heading(`Received Properties: ${project}`);
+  log('');
 
-    if (!data.properties || data.properties.length === 0) {
-      log('  No properties found.');
-      return;
-    }
+  if (ifEmpty(data.properties, 'properties')) return;
 
-    // Group by event for display
-    const byEvent = {};
-    for (const p of data.properties) {
-      if (!byEvent[p.event]) byEvent[p.event] = [];
-      byEvent[p.event].push(p.key);
-    }
+  // Group by event for display
+  const byEvent = {};
+  for (const p of data.properties) {
+    if (!byEvent[p.event]) byEvent[p.event] = [];
+    byEvent[p.event].push(p.key);
+  }
 
-    for (const [event, keys] of Object.entries(byEvent)) {
-      log(`  ${BOLD}${event}${RESET}`);
-      for (const key of keys) {
-        log(`    ${CYAN}${key}${RESET}`);
-      }
+  for (const [event, keys] of Object.entries(byEvent)) {
+    log(`  ${BOLD}${event}${RESET}`);
+    for (const key of keys) {
+      log(`    ${CYAN}${key}${RESET}`);
     }
-
-    log(`\n${DIM}Sampled from last ${data.sample_size} events${RESET}`);
-    log('');
-  } catch (err) {
-    error(`Failed to get properties: ${err.message}`);
   }
-}
-
-async function cmdInsights(project, period = '7d') {
-  if (!project) error('Usage: npx @agent-analytics/cli insights <project-name> [--period 7d]');
 
-  const api = requireKey();
+  log(`\n${DIM}Sampled from last ${data.sample_size} events${RESET}`);
+  log('');
+});
 
-  try {
-    const data = await api.getInsights(project, { period });
+const cmdInsights = withApi(async (api, project, period = '7d') => {
+  if (!project) error('Usage: npx @agent-analytics/cli insights <project-name> [--period 7d]');
 
-    heading(`Insights: ${project} (${period} vs previous)`);
-    log('');
+  const data = await api.getInsights(project, { period });
 
-    const m = data.metrics;
-    for (const [key, metric] of Object.entries(m)) {
-      const label = key.replace(/_/g, ' ');
-      const arrow = metric.change > 0 ? `${GREEN}↑` : metric.change < 0 ? `${RED}↓` : `${DIM}—`;
-      const pct = metric.change_pct !== null ? ` (${metric.change_pct > 0 ? '+' : ''}${metric.change_pct}%)` : '';
-      log(`  ${BOLD}${label}:${RESET}  ${metric.current} ${arrow}${pct}${RESET}  ${DIM}was ${metric.previous}${RESET}`);
-    }
+  heading(`Insights: ${project} (${period} vs previous)`);
+  log('');
 
-    log('');
-    log(`  ${BOLD}Trend:${RESET} ${data.trend}`);
-    log('');
-  } catch (err) {
-    error(`Failed to get insights: ${err.message}`);
+  const m = data.metrics;
+  for (const [key, metric] of Object.entries(m)) {
+    const label = key.replace(/_/g, ' ');
+    const arrow = metric.change > 0 ? `${GREEN}↑` : metric.change < 0 ? `${RED}↓` : `${DIM}—`;
+    const pct = metric.change_pct !== null ? ` (${metric.change_pct > 0 ? '+' : ''}${metric.change_pct}%)` : '';
+    log(`  ${BOLD}${label}:${RESET}  ${metric.current} ${arrow}${pct}${RESET}  ${DIM}was ${metric.previous}${RESET}`);
   }
-}
 
-async function cmdBreakdown(project, property, opts = {}) {
-  if (!project || !property) error('Usage: npx @agent-analytics/cli breakdown <project-name> --property <key> [--event page_view] [--limit 20]');
+  log('');
+  log(`  ${BOLD}Trend:${RESET} ${data.trend}`);
+  log('');
+});
 
-  const api = requireKey();
+const cmdBreakdown = withApi(async (api, project, property, opts = {}) => {
+  if (!project || !property) error('Usage: npx @agent-analytics/cli breakdown <project-name> --property <key> [--event page_view] [--limit 20]');
 
-  try {
-    const data = await api.getBreakdown(project, { property, ...opts });
+  const data = await api.getBreakdown(project, { property, ...opts });
 
-    heading(`Breakdown: ${project} — ${property}${data.event ? ` (${data.event})` : ''}`);
-    log('');
+  heading(`Breakdown: ${project} — ${property}${data.event ? ` (${data.event})` : ''}`);
+  log('');
 
-    if (!data.values || data.values.length === 0) {
-      log('  No data found.');
-      return;
-    }
+  if (ifEmpty(data.values, 'data')) return;
 
-    for (const v of data.values) {
-      log(`  ${BOLD}${v.value}${RESET}  ${v.count} events  ${DIM}(${v.unique_users} users)${RESET}`);
-    }
-    log(`\n${DIM}${data.total_with_property} of ${data.total_events} events have this property${RESET}`);
-    log('');
-  } catch (err) {
-    error(`Failed to get breakdown: ${err.message}`);
+  for (const v of data.values) {
+    log(`  ${BOLD}${v.value}${RESET}  ${v.count} events  ${DIM}(${v.unique_users} users)${RESET}`);
   }
-}
+  log(`\n${DIM}${data.total_with_property} of ${data.total_events} events have this property${RESET}`);
+  log('');
+});
 
-async function cmdPages(project, type = 'entry', opts = {}) {
+const cmdPages = withApi(async (api, project, type = 'entry', opts = {}) => {
   if (!project) error('Usage: npx @agent-analytics/cli pages <project-name> [--type entry|exit|both] [--limit 20]');
 
-  const api = requireKey();
+  const data = await api.getPages(project, { type, ...opts });
 
-  try {
-    const data = await api.getPages(project, { type, ...opts });
-
-    heading(`Pages: ${project} (${type})`);
-    log('');
+  heading(`Pages: ${project} (${type})`);
+  log('');
 
-    const pages = data.entry_pages || data.exit_pages || [];
-    if (pages.length === 0) {
-      log('  No page data found.');
-      return;
-    }
+  const pages = data.entry_pages || data.exit_pages || [];
+  if (ifEmpty(pages, 'page data')) return;
 
-    for (const p of pages) {
-      const bounceStr = `${Math.round(p.bounce_rate * 100)}% bounce`;
-      const durStr = `${Math.round(p.avg_duration / 1000)}s avg`;
-      log(`  ${BOLD}${p.page}${RESET}  ${p.sessions} sessions  ${DIM}${bounceStr}  ${durStr}  ${p.avg_events} events/session${RESET}`);
-    }
+  for (const p of pages) {
+    const bounceStr = `${Math.round(p.bounce_rate * 100)}% bounce`;
+    const durStr = `${Math.round(p.avg_duration / 1000)}s avg`;
+    log(`  ${BOLD}${p.page}${RESET}  ${p.sessions} sessions  ${DIM}${bounceStr}  ${durStr}  ${p.avg_events} events/session${RESET}`);
+  }
 
-    if (data.exit_pages && data.entry_pages) {
-      log('');
-      heading('Exit pages:');
-      for (const p of data.exit_pages) {
-        log(`  ${BOLD}${p.page}${RESET}  ${p.sessions} sessions`);
-      }
-    }
+  if (data.exit_pages && data.entry_pages) {
     log('');
-  } catch (err) {
-    error(`Failed to get pages: ${err.message}`);
+    heading('Exit pages:');
+    for (const p of data.exit_pages) {
+      log(`  ${BOLD}${p.page}${RESET}  ${p.sessions} sessions`);
+    }
   }
-}
+  log('');
+});
 
-async function cmdSessionsDist(project) {
+const cmdSessionsDist = withApi(async (api, project) => {
   if (!project) error('Usage: npx @agent-analytics/cli sessions-dist <project-name>');
 
-  const api = requireKey();
+  const data = await api.getSessionDistribution(project);
 
-  try {
-    const data = await api.getSessionDistribution(project);
-
-    heading(`Session Distribution: ${project}`);
-    log('');
+  heading(`Session Distribution: ${project}`);
+  log('');
 
-    if (!data.distribution || data.distribution.length === 0) {
-      log('  No session data found.');
-      return;
-    }
+  if (ifEmpty(data.distribution, 'session data')) return;
 
-    for (const b of data.distribution) {
-      const bar = '█'.repeat(Math.min(Math.ceil(b.pct / 2), 40));
-      log(`  ${b.bucket.padEnd(7)}  ${GREEN}${bar}${RESET}  ${b.sessions} (${b.pct}%)`);
-    }
-
-    log('');
-    log(`  ${BOLD}Median:${RESET} ${data.median_bucket}  ${BOLD}Engaged:${RESET} ${data.engaged_pct}% (sessions ≥30s)`);
-    log('');
-  } catch (err) {
-    error(`Failed to get session distribution: ${err.message}`);
+  for (const b of data.distribution) {
+    const bar = '█'.repeat(Math.min(Math.ceil(b.pct / 2), 40));
+    log(`  ${b.bucket.padEnd(7)}  ${GREEN}${bar}${RESET}  ${b.sessions} (${b.pct}%)`);
   }
-}
 
-async function cmdHeatmap(project) {
-  if (!project) error('Usage: npx @agent-analytics/cli heatmap <project-name>');
+  log('');
+  log(`  ${BOLD}Median:${RESET} ${data.median_bucket}  ${BOLD}Engaged:${RESET} ${data.engaged_pct}% (sessions ≥30s)`);
+  log('');
+});
 
-  const api = requireKey();
+const cmdHeatmap = withApi(async (api, project) => {
+  if (!project) error('Usage: npx @agent-analytics/cli heatmap <project-name>');
 
-  try {
-    const data = await api.getHeatmap(project);
+  const data = await api.getHeatmap(project);
 
-    heading(`Heatmap: ${project}`);
-    log('');
+  heading(`Heatmap: ${project}`);
+  log('');
 
-    if (!data.heatmap || data.heatmap.length === 0) {
-      log('  No heatmap data found.');
-      return;
-    }
+  if (ifEmpty(data.heatmap, 'heatmap data')) return;
 
-    if (data.peak) {
-      log(`  ${BOLD}Peak:${RESET} ${data.peak.day_name} at ${data.peak.hour}:00 (${data.peak.events} events, ${data.peak.users} users)`);
-    }
-    log(`  ${BOLD}Busiest day:${RESET} ${data.busiest_day}`);
-    log(`  ${BOLD}Busiest hour:${RESET} ${data.busiest_hour}:00`);
-    log('');
-  } catch (err) {
-    error(`Failed to get heatmap: ${err.message}`);
+  if (data.peak) {
+    log(`  ${BOLD}Peak:${RESET} ${data.peak.day_name} at ${data.peak.hour}:00 (${data.peak.events} events, ${data.peak.users} users)`);
   }
-}
+  log(`  ${BOLD}Busiest day:${RESET} ${data.busiest_day}`);
+  log(`  ${BOLD}Busiest hour:${RESET} ${data.busiest_hour}:00`);
+  log('');
+});
 
-async function cmdDelete(id) {
+const cmdDelete = withApi(async (api, id) => {
   if (!id) error('Usage: npx @agent-analytics/cli delete <project-id>');
-
-  const api = requireKey();
-
-  try {
-    await api.deleteProject(id);
-    success(`Project ${id} deleted`);
-  } catch (err) {
-    error(`Failed to delete project: ${err.message}`);
-  }
-}
+  await api.deleteProject(id);
+  success(`Project ${id} deleted`);
+});
 
 function cmdDeleteAccount() {
   heading('Delete Account');
@@ -428,42 +365,146 @@ function cmdDeleteAccount() {
   log('');
 }
 
-async function cmdRevokeKey() {
-  const api = requireKey();
-
-  try {
-    const data = await api.revokeKey();
-    setApiKey(data.api_key);
-
-    warn('Old API key revoked');
-    success('New API key generated and saved\n');
-    heading('New API key:');
-    log(`${YELLOW}${data.api_key}${RESET}`);
-    log(`${DIM}Saved to ~/.config/agent-analytics/config.json${RESET}\n`);
-    warn('Update your agent with this new key!');
-  } catch (err) {
-    error(`Failed to revoke key: ${err.message}`);
+const cmdRevokeKey = withApi(async (api) => {
+  const data = await api.revokeKey();
+  setApiKey(data.api_key);
+
+  warn('Old API key revoked');
+  success('New API key generated and saved\n');
+  heading('New API key:');
+  log(`${YELLOW}${data.api_key}${RESET}`);
+  log(`${DIM}Saved to ~/.config/agent-analytics/config.json${RESET}\n`);
+  warn('Update your agent with this new key!');
+});
+
+const cmdWhoami = withApi(async (api) => {
+  const data = await api.getAccount();
+  heading('Account');
+  log(`  ${BOLD}Email:${RESET}    ${data.email}`);
+  log(`  ${BOLD}GitHub:${RESET}   ${data.github_login || 'N/A'}`);
+  log(`  ${BOLD}Tier:${RESET}     ${data.tier}`);
+  log(`  ${BOLD}Projects:${RESET} ${data.projects_count}/${data.projects_limit}`);
+  if (data.tier === 'pro' && data.monthly_spend_cap_dollars != null) {
+    log(`  ${BOLD}Spend cap:${RESET} $${data.monthly_spend_cap_dollars.toFixed(2)}/month`);
   }
-}
+  log('');
+});
 
-async function cmdWhoami() {
-  const api = requireKey();
+// ==================== EXPERIMENTS ====================
 
-  try {
-    const data = await api.getAccount();
-    heading('Account');
-    log(`  ${BOLD}Email:${RESET}    ${data.email}`);
-    log(`  ${BOLD}GitHub:${RESET}   ${data.github_login || 'N/A'}`);
-    log(`  ${BOLD}Tier:${RESET}     ${data.tier}`);
-    log(`  ${BOLD}Projects:${RESET} ${data.projects_count}/${data.projects_limit}`);
-    if (data.tier === 'pro' && data.monthly_spend_cap_dollars != null) {
-      log(`  ${BOLD}Spend cap:${RESET} $${data.monthly_spend_cap_dollars.toFixed(2)}/month`);
+const cmdExperiments = withApi(async (api, sub, ...rest) => {
+  if (!sub) error('Usage: npx @agent-analytics/cli experiments <list|create|get|pause|resume|complete|delete> ...');
+
+  switch (sub) {
+    case 'list': {
+      const project = rest[0];
+      if (!project) error('Usage: npx @agent-analytics/cli experiments list <project>');
+      const data = await api.listExperiments(project);
+      heading(`Experiments: ${project}`);
+      log('');
+      if (ifEmpty(data.experiments, 'experiments')) return;
+      for (const e of data.experiments) {
+        const status = e.status === 'active' ? `${GREEN}active${RESET}` : e.status === 'paused' ? `${YELLOW}paused${RESET}` : `${DIM}completed${RESET}`;
+        log(`  ${BOLD}${e.name}${RESET}  ${DIM}${e.id}${RESET}  ${status}  ${DIM}goal: ${e.goal_event}${RESET}`);
+        const variants = e.variants.map(v => `${v.key}(${v.weight}%)`).join(', ');
+        log(`    variants: ${variants}`);
+        if (e.winner) log(`    ${GREEN}winner: ${e.winner}${RESET}`);
+      }
+      log('');
+      break;
     }
-    log('');
-  } catch (err) {
-    error(`Failed to get account: ${err.message}`);
+    case 'create': {
+      const project = rest[0];
+      if (!project) error('Usage: npx @agent-analytics/cli experiments create <project> --name <name> --variants control,new_cta --goal <event> [--weights 60,40]');
+      const name = getArg('--name');
+      const variantsStr = getArg('--variants');
+      const goal = getArg('--goal');
+      if (!name || !variantsStr || !goal) error('Required: --name, --variants, --goal');
+      const variants = variantsStr.split(',').map(v => v.trim());
+      const weightsStr = getArg('--weights');
+      const weights = weightsStr ? weightsStr.split(',').map(w => parseInt(w.trim(), 10)) : undefined;
+      const data = await api.createExperiment(project, { name, variants, goal_event: goal, weights });
+      success(`Experiment created: ${BOLD}${data.name}${RESET} (${data.id})`);
+      log(`  ${DIM}variants:${RESET} ${data.variants.map(v => `${v.key}(${v.weight}%)`).join(', ')}`);
+      log(`  ${DIM}goal:${RESET} ${data.goal_event}`);
+      log('');
+      break;
+    }
+    case 'get': {
+      const id = rest[0];
+      if (!id) error('Usage: npx @agent-analytics/cli experiments get <id>');
+      const data = await api.getExperiment(id);
+      const status = data.status === 'active' ? `${GREEN}active${RESET}` : data.status === 'paused' ? `${YELLOW}paused${RESET}` : `${DIM}completed${RESET}`;
+      heading(`Experiment: ${data.name}`);
+      log(`  ${DIM}id:${RESET} ${data.id}  status: ${status}  ${DIM}goal: ${data.goal_event}${RESET}`);
+      if (data.winner) log(`  ${GREEN}winner: ${data.winner}${RESET}`);
+      log('');
+      if (data.results) {
+        heading('Results:');
+        for (const v of data.results.variants) {
+          const rate = (v.conversion_rate * 100).toFixed(1);
+          log(`  ${BOLD}${v.key}${RESET}  ${v.unique_users} users  ${v.conversions} conversions  ${CYAN}${rate}%${RESET}`);
+        }
+        log('');
+        if (data.results.probability_best) {
+          heading('Probability best:');
+          for (const [k, v] of Object.entries(data.results.probability_best)) {
+            const pct = (v * 100).toFixed(1);
+            log(`  ${BOLD}${k}:${RESET} ${pct}%`);
+          }
+        }
+        if (data.results.lift) {
+          heading('Lift:');
+          for (const [k, v] of Object.entries(data.results.lift)) {
+            const pct = (v * 100).toFixed(1);
+            const arrow = v > 0 ? `${GREEN}+${pct}%` : v < 0 ? `${RED}${pct}%` : `${DIM}0%`;
+            log(`  ${BOLD}${k}:${RESET} ${arrow}${RESET}`);
+          }
+        }
+        log('');
+        log(`  ${BOLD}Sufficient data:${RESET} ${data.results.sufficient_data ? `${GREEN}yes` : `${YELLOW}no`}${RESET}`);
+        if (data.results.recommendation) {
+          log(`  ${BOLD}Recommendation:${RESET} ${data.results.recommendation}`);
+        }
+      } else {
+        log(`  ${DIM}No results available yet (need exposure + conversion events)${RESET}`);
+      }
+      log('');
+      break;
+    }
+    case 'pause': {
+      const id = rest[0];
+      if (!id) error('Usage: npx @agent-analytics/cli experiments pause <id>');
+      await api.updateExperiment(id, { status: 'paused' });
+      success(`Experiment ${id} paused`);
+      break;
+    }
+    case 'resume': {
+      const id = rest[0];
+      if (!id) error('Usage: npx @agent-analytics/cli experiments resume <id>');
+      await api.updateExperiment(id, { status: 'active' });
+      success(`Experiment ${id} resumed`);
+      break;
+    }
+    case 'complete': {
+      const id = rest[0];
+      if (!id) error('Usage: npx @agent-analytics/cli experiments complete <id> [--winner <variant>]');
+      const winner = getArg('--winner');
+      await api.updateExperiment(id, { status: 'completed', winner });
+      success(`Experiment ${id} completed${winner ? ` — winner: ${winner}` : ''}`);
+      break;
+    }
+    case 'delete': {
+      const id = rest[0];
+      if (!id) error('Usage: npx @agent-analytics/cli experiments delete <id>');
+      await api.deleteExperiment(id);
+      success(`Experiment ${id} deleted`);
+      break;
+    }
+    default:
+      error(`Unknown experiments subcommand: ${sub}. Use: list, create, get, pause, resume, complete, delete`);
   }
-}
+});
 
 function showHelp() {
   log(`
@@ -486,6 +527,14 @@ ${BOLD}COMMANDS${RESET}
   ${CYAN}pages${RESET} <name>       Entry/exit page performance
   ${CYAN}sessions-dist${RESET} <name>  Session duration distribution
   ${CYAN}heatmap${RESET} <name>     Peak hours & busiest days
+  ${CYAN}experiments${RESET} <sub>  A/B testing (pro only)
+    ${DIM}list <project>${RESET}      List experiments
+    ${DIM}create <project>${RESET}    Create experiment
+    ${DIM}get <id>${RESET}            Get experiment with results
+    ${DIM}pause <id>${RESET}          Pause experiment
+    ${DIM}resume <id>${RESET}         Resume experiment
+    ${DIM}complete <id>${RESET}       Complete experiment
+    ${DIM}delete <id>${RESET}         Delete experiment
   ${CYAN}whoami${RESET}             Show current account
   ${CYAN}revoke-key${RESET}         Revoke and regenerate API key
   ${CYAN}delete-account${RESET}     Delete your account (opens dashboard)
@@ -500,6 +549,11 @@ ${BOLD}OPTIONS${RESET}
   --property <key>   Property key for breakdown (required)
   --event <name>     Filter by event name (breakdown only)
   --type <T>         Page type: entry, exit, both (default: entry)
+  --name <name>      Experiment name (experiments create)
+  --variants <a,b>   Comma-separated variant keys (experiments create)
+  --goal <event>     Goal event name (experiments create)
+  --weights <50,50>  Comma-separated weights (experiments create, optional)
+  --winner <variant> Winning variant (experiments complete, optional)
 
 ${BOLD}ENVIRONMENT${RESET}
   AGENT_ANALYTICS_API_KEY    API key (overrides config file)
@@ -581,6 +635,9 @@ try {
     case 'heatmap':
       await cmdHeatmap(args[1]);
       break;
+    case 'experiments':
+      await cmdExperiments(args[1], args[2]);
+      break;
     case 'delete':
       await cmdDelete(args[1]);
       break;

package/lib/api.mjs

@@ -11,6 +11,13 @@ export class AgentAnalyticsAPI {
     this.baseUrl = baseUrl;
   }
 
+  _qs(params) {
+    return Object.entries(params)
+      .filter(([, v]) => v != null)
+      .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+      .join('&');
+  }
+
   async request(method, path, body, { returnHeaders = false } = {}) {
     const opts = {
       method,
@@ -68,55 +75,60 @@ export class AgentAnalyticsAPI {
 
   // Stats
   async getStats(project, days = 7, { returnHeaders = false } = {}) {
-    return this.request('GET', `/stats?project=${encodeURIComponent(project)}&days=${days}`, undefined, { returnHeaders });
+    return this.request('GET', `/stats?${this._qs({ project, days })}`, undefined, { returnHeaders });
   }
 
   async getEvents(project, { event, days = 7, limit = 100 } = {}) {
-    let qs = `project=${encodeURIComponent(project)}&days=${days}&limit=${limit}`;
-    if (event) qs += `&event=${encodeURIComponent(event)}`;
-    return this.request('GET', `/events?${qs}`);
+    return this.request('GET', `/events?${this._qs({ project, days, limit, event })}`);
   }
 
   async getProperties(project, days = 30) {
-    return this.request('GET', `/properties?project=${encodeURIComponent(project)}&days=${days}`);
+    return this.request('GET', `/properties?${this._qs({ project, days })}`);
   }
 
   async getPropertiesReceived(project, { since, sample } = {}) {
-    let qs = `project=${encodeURIComponent(project)}`;
-    if (since) qs += `&since=${encodeURIComponent(since)}`;
-    if (sample) qs += `&sample=${sample}`;
-    return this.request('GET', `/properties/received?${qs}`);
+    return this.request('GET', `/properties/received?${this._qs({ project, since, sample })}`);
   }
 
   // Analytics
   async getBreakdown(project, { property, event, since, limit = 20 } = {}) {
-    let qs = `project=${encodeURIComponent(project)}&property=${encodeURIComponent(property)}`;
-    if (event) qs += `&event=${encodeURIComponent(event)}`;
-    if (since) qs += `&since=${encodeURIComponent(since)}`;
-    if (limit) qs += `&limit=${limit}`;
-    return this.request('GET', `/breakdown?${qs}`);
+    return this.request('GET', `/breakdown?${this._qs({ project, property, event, since, limit })}`);
   }
 
   async getInsights(project, { period = '7d' } = {}) {
-    return this.request('GET', `/insights?project=${encodeURIComponent(project)}&period=${period}`);
+    return this.request('GET', `/insights?${this._qs({ project, period })}`);
   }
 
   async getPages(project, { type = 'entry', since, limit = 20 } = {}) {
-    let qs = `project=${encodeURIComponent(project)}&type=${type}`;
-    if (since) qs += `&since=${encodeURIComponent(since)}`;
-    if (limit) qs += `&limit=${limit}`;
-    return this.request('GET', `/pages?${qs}`);
+    return this.request('GET', `/pages?${this._qs({ project, type, since, limit })}`);
   }
 
   async getSessionDistribution(project, { since } = {}) {
-    let qs = `project=${encodeURIComponent(project)}`;
-    if (since) qs += `&since=${encodeURIComponent(since)}`;
-    return this.request('GET', `/sessions/distribution?${qs}`);
+    return this.request('GET', `/sessions/distribution?${this._qs({ project, since })}`);
   }
 
   async getHeatmap(project, { since } = {}) {
-    let qs = `project=${encodeURIComponent(project)}`;
-    if (since) qs += `&since=${encodeURIComponent(since)}`;
-    return this.request('GET', `/heatmap?${qs}`);
+    return this.request('GET', `/heatmap?${this._qs({ project, since })}`);
+  }
+
+  // Experiments
+  async createExperiment(project, { name, variants, goal_event, weights }) {
+    return this.request('POST', '/experiments', { project, name, variants, goal_event, weights });
+  }
+
+  async listExperiments(project) {
+    return this.request('GET', `/experiments?${this._qs({ project })}`);
+  }
+
+  async getExperiment(id) {
+    return this.request('GET', `/experiments/${id}`);
+  }
+
+  async updateExperiment(id, { status, winner }) {
+    return this.request('PATCH', `/experiments/${id}`, { status, winner });
+  }
+
+  async deleteExperiment(id) {
+    return this.request('DELETE', `/experiments/${id}`);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-analytics/cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Web analytics your AI agent can read. CLI for managing projects and querying stats.",
   "bin": {
     "agent-analytics": "./bin/cli.mjs"