burnwatch 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to burnwatch will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-03-24
+
+### Added
+
+- **Interactive init with plan tiers**: `burnwatch init` now walks through each detected service interactively, grouped by cost risk (LLMs first, then usage-based, infra, flat-rate). Users pick from known plan tiers per service (e.g., Anthropic API Usage, Max $100/mo, Pro $20/mo, or "Don't track").
+- **Plan tiers for all 14 services**: Registry now includes plan options for Anthropic, OpenAI, Google Gemini, Voyage AI, Vercel, Supabase, Stripe, Scrapfly, Browserbase, Upstash, Resend, Inngest, PostHog, and AWS.
+- **Smart defaults**: Each service has a recommended default plan. Flat plans auto-set the budget to the plan cost. API Usage plans prompt for keys and budgets.
+- **Exclude option**: "Don't track for this project" explicitly excludes a service (shows as "excluded", not BLIND).
+- **Auto-detect plan**: Scrapfly plan can be auto-detected from API key via the /account endpoint.
+- **Non-interactive fallback**: `burnwatch init --non-interactive` preserves the original auto-detect behavior for CI/scripted use.
+- **Predictive cost impact analysis**: PostToolUse hook now analyzes file writes for SDK call sites, detects multipliers (loops, .map(), Promise.all, cron schedules, batch sizes), and projects monthly cost ranges using registry pricing data and gotcha-based multipliers.
+- **Cost impact cards**: When a file write contains tracked service SDK calls, a cost impact card is injected into Claude's context with estimated monthly cost, current budget status, and cheaper alternatives.
+- **Cumulative session cost tracking**: Session cost impacts are accumulated across file changes and reported in the Stop hook.
+- **Projected impact in ledger**: The spend ledger now includes a "projected impact" row showing session cost estimates.
+- **New `excluded` confidence tier**: Services explicitly excluded by the user show ⬚ SKIP instead of 🔴 BLIND.
+
+### Changed
+
+- Registry version bumped to 0.2.0 with plan tier data.
+- CLI now parses `--non-interactive` and `--ni` flags.
+- PostToolUse hook expanded from detection-only to detection + cost impact analysis.
+- Stop hook now reads and reports cumulative session cost impacts.
+
 ## [0.1.0] - 2026-03-24
 
 ### Added
@@ -20,4 +43,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Snapshot system for delta computation across sessions
 - Claude Code skills: `/spend` (on-demand brief), `/setup-burnwatch` (guided onboarding)
 
+[0.4.0]: https://github.com/RaleighSF/burnwatch/compare/v0.1.0...v0.4.0
 [0.1.0]: https://github.com/RaleighSF/burnwatch/releases/tag/v0.1.0

package/README.md

@@ -12,24 +12,24 @@
 
 <br>
 
-burnwatch detects every paid service in your project, tracks what you're spending, and injects budget context directly into your AI coding sessions — so the agent knows what things cost before it recommends burning more money.
+burnwatch detects every paid service in your project, tracks what you're spending, and injects budget context directly into your AI coding sessions - so the agent knows what things cost before it recommends burning more money.
 
 ```
-╔══════════════════════════════════════════════════════════════╗
-║  BURNWATCH — hullscore — March 2026                          ║
-╠══════════════════════════════════════════════════════════════╣
-║  Service        Spend       Conf    Budget  Left             ║
-║  ──────────────────────────────────────────────────────────  ║
-║  Anthropic      $47.20      ✅ LIVE  $100    53%             ║
-║  Vercel         $23.00      ✅ LIVE  $50     54%             ║
-║  Scrapfly       $127.00     ✅ LIVE  $50     ⚠️ OVR          ║
-║  Browserbase    ~$63.00     🟠 EST   $75     16%             ║
-║  Supabase       $25.00      ✅ LIVE  $100    75%             ║
-║  PostHog        ~$49.00     🟡 CALC  $49     0%              ║
-╠══════════════════════════════════════════════════════════════╣
-║  TOTAL: ~$334.20   Untracked: 0 ✅   Est margin: ±$20       ║
-║  🚨  SCRAPFLY 254% OVER BUDGET — review before use          ║
-╚══════════════════════════════════════════════════════════════╝
+╔══════════════════════════════════════════════════════════════
+║  BURNWATCH - your-app - March 2026
+╠══════════════════════════════════════════════════════════════
+║  Service        Spend       Conf      Budget  Left
+║  ──────────────────────────────────────────────────────────
+║  Anthropic      $47.20      ✅ LIVE    $100    53%
+║  Vercel         $23.00      ✅ LIVE    $50     54%
+║  Scrapfly       $127.00     ✅ LIVE    $50     ⚠️ OVR
+║  Browserbase    ~$63.00     🟠 EST     $75     16%
+║  Supabase       $25.00      ✅ LIVE    $100    75%
+║  PostHog        ~$49.00     🟡 CALC    $49     0%
+╠══════════════════════════════════════════════════════════════
+║  TOTAL: ~$334.20   Untracked: 0 ✅   Est margin: ±$20
+║  🚨 SCRAPFLY 254% OVER BUDGET - review before use
+╚══════════════════════════════════════════════════════════════
 ```
 
 This brief appears automatically at the start of every [Claude Code](https://claude.ai/code) session. You don't open a dashboard. You don't remember to check anything. You just see what you're spending.
@@ -38,7 +38,7 @@ This brief appears automatically at the start of every [Claude Code](https://cla
 
 ## Why
 
-Agentic development lets you ship 10x faster. It also lets you burn through $400 in Scrapfly credits, rack up unexpected Browserbase bills, and discover PostHog overages three weeks after the code that caused them was written — by an agent, in a session you barely remember.
+Agentic development lets you ship 10x faster. It also lets you burn through $400 in Scrapfly credits, rack up unexpected Browserbase bills, and discover PostHog overages three weeks after the code that caused them was written - by an agent, in a session you barely remember.
 
 **78% of IT leaders experienced unexpected charges** tied to consumption-based or AI pricing in the past 12 months ([Zylo 2026 SaaS Management Index](https://zylo.com/research/saas-management-index/)).
 
@@ -56,7 +56,7 @@ npx burnwatch init
 
 That's it. burnwatch scans your project, detects paid services, creates a `.burnwatch/` directory, and registers Claude Code hooks. Next time you start a session, you see your spend.
 
-> **Requirements:** Node.js 18+ &mdash; Zero dependencies &mdash; Works with or without Claude Code
+> **Requirements:** Node.js 18+ · Zero dependencies · Works with or without Claude Code
 
 <br>
 
@@ -91,12 +91,12 @@ npx burnwatch init
 ### 2. Add API keys and budgets
 
 ```bash
-# LIVE tracking — real billing API data
+# LIVE tracking - real billing API data
 burnwatch add anthropic --key $ANTHROPIC_ADMIN_KEY --budget 100
 burnwatch add scrapfly --key $SCRAPFLY_KEY --budget 50
 burnwatch add vercel --token $VERCEL_TOKEN --budget 50
 
-# CALC tracking — flat-rate services
+# CALC tracking - flat-rate services
 burnwatch add posthog --plan-cost 0 --budget 0
 burnwatch add inngest --plan-cost 25 --budget 25
 
@@ -119,13 +119,13 @@ Start a Claude Code session. The spend brief appears automatically. When you men
 ```
 You: "Use Scrapfly to scrape the competitor pricing pages"
 
-[BURNWATCH] scrapfly — current period
+[BURNWATCH] scrapfly - current period
   Spend: $127.00  |  Budget: $50  |  ⚠️ 254% over
   Confidence: ✅ LIVE
   ⚠️ 254% of budget consumed
 ```
 
-Claude factors this into its response — it might suggest Cheerio instead, or warn you before proceeding.
+Claude factors this into its response - it might suggest Cheerio instead, or warn you before proceeding.
 
 When a new paid service enters your project (new dependency, new env var, new import), burnwatch alerts immediately:
 
@@ -138,7 +138,7 @@ When a new paid service enters your project (new dependency, new env var, new im
 
 ## How It Works
 
-burnwatch runs as [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — background scripts that fire on session lifecycle events. It never proxies your traffic. It never intercepts API calls. It watches the exhaust of your sessions silently, completely, and without interrupting the work.
+burnwatch runs as [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) - background scripts that fire on session lifecycle events. It never proxies your traffic. It never intercepts API calls. It watches the exhaust of your sessions silently, completely, and without interrupting the work.
 
 ### Four Detection Surfaces
 
@@ -172,18 +172,18 @@ If burnwatch can't track a service accurately, it says so. The ledger always sho
 
 ### The Ledger
 
-burnwatch writes `.burnwatch/spend-ledger.md` at the end of every session — human-readable, git-committable, designed to be read in 10 seconds:
+burnwatch writes `.burnwatch/spend-ledger.md` at the end of every session - human-readable, git-committable, designed to be read in 10 seconds:
 
 ```markdown
-# Burnwatch Ledger — hullscore
+# Burnwatch Ledger - your-app
 Last updated: 2026-03-24T14:32:11Z
 
 ## This Month (March 2026)
 | Service | Spend | Conf | Budget | Status |
 |---------|-------|------|--------|--------|
-| Anthropic | $47.20 | ✅ LIVE | $100 | 53% — healthy |
+| Anthropic | $47.20 | ✅ LIVE | $100 | 53% - healthy |
 | Scrapfly | $127.00 | ✅ LIVE | $50 | ⚠️ 254% over |
-| Vercel | $23.00 | ✅ LIVE | $50 | 54% — healthy |
+| Vercel | $23.00 | ✅ LIVE | $50 | 54% - healthy |
 
 ## TOTAL: ~$209.70 (±$2 estimated margin)
 ## Untracked services: 0
@@ -216,7 +216,7 @@ Last updated: 2026-03-24T14:32:11Z
 
 ## How the Agent Changes Behavior
 
-The real power isn't showing _you_ what you spent — it's telling _the agent_ what everything costs, in context, so cost becomes a factor in every recommendation.
+The real power isn't showing _you_ what you spent - it's telling _the agent_ what everything costs, in context, so cost becomes a factor in every recommendation.
 
 When Claude sees `Scrapfly: $127 / $50 budget, 254% over` in its context, it:
 
@@ -281,7 +281,7 @@ burnwatch doesn't need to run in every session. It takes snapshots when present
 burnwatch reconcile
 ```
 
-Re-scans your project for services introduced in sessions where burnwatch wasn't active. For billing APIs that expose cumulative usage (like Scrapfly's credit counter), it computes the delta between snapshots — attributing spend across the gap.
+Re-scans your project for services introduced in sessions where burnwatch wasn't active. For billing APIs that expose cumulative usage (like Scrapfly's credit counter), it computes the delta between snapshots - attributing spend across the gap.
 
 <br>
 
@@ -304,7 +304,7 @@ Re-scans your project for services introduced in sessions where burnwatch wasn't
 }
 ```
 
-The `gotchas` and `alternatives` fields aren't just metadata — the agent reads them and uses them to make better recommendations. Every PR that adds a service makes burnwatch smarter for every user.
+The `gotchas` and `alternatives` fields aren't just metadata - the agent reads them and uses them to make better recommendations. Every PR that adds a service makes burnwatch smarter for every user.
 
 <br>
 

package/dist/cli.js

@@ -579,7 +579,8 @@ var CONFIDENCE_BADGES = {
   live: "\u2705 LIVE",
   calc: "\u{1F7E1} CALC",
   est: "\u{1F7E0} EST",
-  blind: "\u{1F534} BLIND"
+  blind: "\u{1F534} BLIND",
+  excluded: "\u2B1A SKIP"
 };
 
 // src/core/brief.ts
@@ -744,6 +745,14 @@ function writeLedger(brief, projectRoot) {
       `| ${svc.serviceId} | ${spendStr} | ${badge} | ${budgetStr} | ${svc.statusLabel} |`
     );
   }
+  const impactAlert = brief.alerts.find(
+    (a) => a.serviceId === "_session_impact"
+  );
+  if (impactAlert) {
+    lines.push(
+      `| _projected impact_ | \u2014 | \u{1F4C8} EST | \u2014 | ${impactAlert.message} |`
+    );
+  }
   lines.push("");
   const totalStr = brief.totalIsEstimate ? `~$${brief.totalSpend.toFixed(2)}` : `$${brief.totalSpend.toFixed(2)}`;
   const marginStr = brief.estimateMargin > 0 ? ` (\xB1$${brief.estimateMargin.toFixed(0)} estimated margin)` : "";
@@ -776,9 +785,188 @@ function saveSnapshot(brief, projectRoot) {
   );
 }
 
+// src/interactive-init.ts
+import * as readline from "readline";
+var RISK_ORDER = ["llm", "usage", "infra", "flat"];
+var RISK_LABELS = {
+  llm: "\u{1F916} LLM / AI Services (highest variable cost)",
+  usage: "\u{1F4CA} Usage-Based Services",
+  infra: "\u{1F3D7}\uFE0F  Infrastructure & Compute",
+  flat: "\u{1F4E6} Flat-Rate / Free Tier Services"
+};
+function classifyRisk(service) {
+  if (service.billingModel === "token_usage") return "llm";
+  if (service.billingModel === "credit_pool" || service.billingModel === "percentage" || service.billingModel === "per_unit")
+    return "usage";
+  if (service.billingModel === "compute") return "infra";
+  return "flat";
+}
+function groupByRisk(detected) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const cat of RISK_ORDER) {
+    groups.set(cat, []);
+  }
+  for (const det of detected) {
+    const cat = classifyRisk(det.service);
+    groups.get(cat).push(det);
+  }
+  return groups;
+}
+function ask(rl, question) {
+  return new Promise((resolve3) => {
+    rl.question(question, (answer) => {
+      resolve3(answer.trim());
+    });
+  });
+}
+async function autoDetectScrapflyPlan(apiKey) {
+  try {
+    const result = await fetchJson(`https://api.scrapfly.io/account?key=${apiKey}`);
+    if (result.ok && result.data?.subscription?.plan?.name) {
+      return result.data.subscription.plan.name;
+    }
+  } catch {
+  }
+  return null;
+}
+async function runInteractiveInit(detected) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const services = {};
+  const groups = groupByRisk(detected);
+  const globalConfig = readGlobalConfig();
+  console.log(
+    "\n\u{1F4CB} Let's configure each detected service. Services are grouped by cost risk.\n"
+  );
+  for (const category of RISK_ORDER) {
+    const group = groups.get(category);
+    if (group.length === 0) continue;
+    console.log(`
+${RISK_LABELS[category]}`);
+    console.log("\u2500".repeat(50));
+    for (const det of group) {
+      const service = det.service;
+      const plans = service.plans;
+      console.log(`
+  ${service.name}`);
+      console.log(`  Detected via: ${det.details.join(", ")}`);
+      if (!plans || plans.length === 0) {
+        services[service.id] = {
+          serviceId: service.id,
+          detectedVia: det.sources,
+          hasApiKey: false,
+          firstDetected: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        console.log("  \u2192 Auto-configured (no plan tiers available)");
+        continue;
+      }
+      const defaultIndex = plans.findIndex((p) => p.default);
+      console.log("");
+      for (let i = 0; i < plans.length; i++) {
+        const plan = plans[i];
+        const marker = i === defaultIndex ? " (recommended)" : "";
+        const costStr = plan.type === "exclude" ? "" : plan.monthlyBase !== void 0 ? ` \u2014 $${plan.monthlyBase}/mo` : " \u2014 variable";
+        console.log(`    ${i + 1}) ${plan.name}${costStr}${marker}`);
+      }
+      const defaultChoice = defaultIndex >= 0 ? String(defaultIndex + 1) : "1";
+      const answer = await ask(
+        rl,
+        `  Choose [${defaultChoice}]: `
+      );
+      const choiceIndex = (answer === "" ? parseInt(defaultChoice) : parseInt(answer)) - 1;
+      const chosen = plans[choiceIndex] ?? plans[defaultIndex >= 0 ? defaultIndex : 0];
+      if (chosen.type === "exclude") {
+        services[service.id] = {
+          serviceId: service.id,
+          detectedVia: det.sources,
+          hasApiKey: false,
+          firstDetected: (/* @__PURE__ */ new Date()).toISOString(),
+          excluded: true,
+          planName: chosen.name
+        };
+        console.log(`  \u2192 ${service.name}: excluded from tracking`);
+        continue;
+      }
+      const tracked = {
+        serviceId: service.id,
+        detectedVia: det.sources,
+        hasApiKey: false,
+        firstDetected: (/* @__PURE__ */ new Date()).toISOString(),
+        planName: chosen.name
+      };
+      if (chosen.type === "flat" && chosen.monthlyBase !== void 0) {
+        tracked.planCost = chosen.monthlyBase;
+        if (chosen.monthlyBase > 0) {
+          tracked.budget = chosen.monthlyBase;
+        }
+      }
+      if (service.apiTier === "live" || chosen.requiresKey) {
+        const existingKey = globalConfig.services[service.id]?.apiKey;
+        if (existingKey) {
+          console.log(`  \u{1F510} Using existing API key from global config`);
+          tracked.hasApiKey = true;
+          if (service.autoDetectPlan && service.id === "scrapfly") {
+            console.log("  \u{1F50D} Auto-detecting plan from API...");
+            const planName = await autoDetectScrapflyPlan(existingKey);
+            if (planName) {
+              console.log(`  \u2192 Detected plan: ${planName}`);
+              tracked.planName = planName;
+            }
+          }
+        } else if (chosen.requiresKey) {
+          const keyAnswer = await ask(
+            rl,
+            `  Enter API key (or press Enter to skip): `
+          );
+          if (keyAnswer) {
+            tracked.hasApiKey = true;
+            if (!globalConfig.services[service.id]) {
+              globalConfig.services[service.id] = {};
+            }
+            globalConfig.services[service.id].apiKey = keyAnswer;
+            if (service.autoDetectPlan && service.id === "scrapfly") {
+              console.log("  \u{1F50D} Auto-detecting plan from API...");
+              const planName = await autoDetectScrapflyPlan(keyAnswer);
+              if (planName) {
+                console.log(`  \u2192 Detected plan: ${planName}`);
+                tracked.planName = planName;
+              }
+            }
+          }
+        }
+      }
+      if (tracked.budget === void 0 || tracked.budget === 0) {
+        const suggestion = chosen.monthlyBase && chosen.monthlyBase > 0 ? ` [${chosen.monthlyBase}]` : "";
+        const budgetAnswer = await ask(
+          rl,
+          `  Monthly budget in USD${suggestion} (or press Enter to skip): $`
+        );
+        if (budgetAnswer) {
+          const budget = parseFloat(budgetAnswer);
+          if (!isNaN(budget)) {
+            tracked.budget = budget;
+          }
+        }
+      }
+      services[service.id] = tracked;
+      const tierLabel = tracked.hasApiKey ? "\u2705 LIVE" : tracked.planCost !== void 0 ? "\u{1F7E1} CALC" : "\u{1F534} BLIND";
+      const budgetStr = tracked.budget !== void 0 ? ` | Budget: $${tracked.budget}/mo` : "";
+      console.log(
+        `  \u2192 ${service.name}: ${chosen.name} (${tierLabel}${budgetStr})`
+      );
+    }
+  }
+  writeGlobalConfig(globalConfig);
+  rl.close();
+  return { services };
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
+var flags = new Set(args.slice(1));
 async function main() {
   switch (command) {
     case "init":
@@ -818,6 +1006,7 @@ async function main() {
 }
 async function cmdInit() {
   const projectRoot = process.cwd();
+  const nonInteractive = flags.has("--non-interactive") || flags.has("--ni");
   if (isInitialized(projectRoot)) {
     console.log("\u2705 burnwatch is already initialized in this project.");
     console.log(`   Config: ${projectConfigDir(projectRoot)}/config.json`);
@@ -839,14 +1028,32 @@ async function cmdInit() {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  for (const det of detected) {
-    const tracked = {
-      serviceId: det.service.id,
-      detectedVia: det.sources,
-      hasApiKey: false,
-      firstDetected: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    config.services[det.service.id] = tracked;
+  if (!nonInteractive && detected.length > 0 && process.stdin.isTTY) {
+    const result = await runInteractiveInit(detected);
+    config.services = result.services;
+  } else {
+    for (const det of detected) {
+      const tracked2 = {
+        serviceId: det.service.id,
+        detectedVia: det.sources,
+        hasApiKey: false,
+        firstDetected: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      config.services[det.service.id] = tracked2;
+    }
+    if (detected.length === 0) {
+      console.log("   No paid services detected yet.");
+      console.log("   Services will be detected as they enter your project.\n");
+    } else {
+      console.log(`   Found ${detected.length} paid service${detected.length > 1 ? "s" : ""}:
+`);
+      for (const det of detected) {
+        const tierBadge = det.service.apiTier === "live" ? "\u2705 LIVE API available" : det.service.apiTier === "calc" ? "\u{1F7E1} Flat-rate tracking" : det.service.apiTier === "est" ? "\u{1F7E0} Estimate tracking" : "\u{1F534} Detection only";
+        console.log(`   \u2022 ${det.service.name} (${tierBadge})`);
+        console.log(`     Detected via: ${det.details.join(", ")}`);
+      }
+      console.log("");
+    }
   }
   writeProjectConfig(config, projectRoot);
   const gitignorePath = path5.join(projectConfigDir(projectRoot), ".gitignore");
@@ -861,29 +1068,29 @@ async function cmdInit() {
     ].join("\n"),
     "utf-8"
   );
-  if (detected.length === 0) {
-    console.log("   No paid services detected yet.");
-    console.log("   Services will be detected as they enter your project.\n");
-  } else {
-    console.log(`   Found ${detected.length} paid service${detected.length > 1 ? "s" : ""}:
-`);
-    for (const det of detected) {
-      const tierBadge = det.service.apiTier === "live" ? "\u2705 LIVE API available" : det.service.apiTier === "calc" ? "\u{1F7E1} Flat-rate tracking" : det.service.apiTier === "est" ? "\u{1F7E0} Estimate tracking" : "\u{1F534} Detection only";
-      console.log(`   \u2022 ${det.service.name} (${tierBadge})`);
-      console.log(`     Detected via: ${det.details.join(", ")}`);
-    }
-    console.log("");
-  }
-  console.log("\u{1F517} Registering Claude Code hooks...\n");
+  console.log("\n\u{1F517} Registering Claude Code hooks...\n");
   registerHooks(projectRoot);
+  const excluded = Object.values(config.services).filter((s) => s.excluded);
+  const tracked = Object.values(config.services).filter((s) => !s.excluded);
   console.log("\u2705 burnwatch initialized!\n");
-  console.log("Next steps:");
-  console.log("  1. Add API keys for LIVE tracking:");
-  console.log("     burnwatch add anthropic --key $ANTHROPIC_ADMIN_KEY --budget 100");
-  console.log("  2. Set budgets for detected services:");
-  console.log("     burnwatch add scrapfly --key $SCRAPFLY_KEY --budget 50");
-  console.log("  3. Check your spend:");
-  console.log("     burnwatch status\n");
+  if (tracked.length > 0) {
+    console.log(`   Tracking ${tracked.length} service${tracked.length > 1 ? "s" : ""}`);
+    for (const svc of tracked) {
+      const planStr = svc.planName ? ` (${svc.planName})` : "";
+      const budgetStr = svc.budget !== void 0 ? ` \u2014 $${svc.budget}/mo budget` : "";
+      console.log(`   \u2022 ${svc.serviceId}${planStr}${budgetStr}`);
+    }
+  }
+  if (excluded.length > 0) {
+    console.log(`
+   Excluded ${excluded.length} service${excluded.length > 1 ? "s" : ""}:`);
+    for (const svc of excluded) {
+      console.log(`   \u2022 ${svc.serviceId}`);
+    }
+  }
+  console.log("\nNext steps:");
+  console.log("  burnwatch status     \u2014 Check your spend");
+  console.log("  burnwatch add <svc>  \u2014 Configure additional services\n");
 }
 async function cmdAdd() {
   const projectRoot = process.cwd();
@@ -1045,7 +1252,8 @@ function cmdHelp() {
 burnwatch \u2014 Passive cost memory for vibe coding
 
 Usage:
-  burnwatch init                              Initialize in current project
+  burnwatch init                              Interactive setup \u2014 pick plans per service
+  burnwatch init --non-interactive            Auto-detect services, no prompts
   burnwatch setup                             Init + auto-configure all detected services
   burnwatch add <service> [options]           Register a service for tracking
   burnwatch status                            Show current spend brief
@@ -1060,6 +1268,7 @@ Options for 'add':
 
 Examples:
   burnwatch init
+  burnwatch init --non-interactive
   burnwatch add anthropic --key sk-ant-admin-xxx --budget 100
   burnwatch add scrapfly --key scp-xxx --budget 50
   burnwatch add posthog --plan-cost 0 --budget 0