burnwatch 0.8.2 → 0.10.0

package/README.md

@@ -88,20 +88,28 @@ npx burnwatch init
 ✅ burnwatch initialized!
 ```
 
-### 2. Add API keys and budgets
+### 2. Configure your services
+
+**In Claude Code (recommended):** Just ask the agent:
+
+```
+You: "Let's set up burnwatch for this project"
+```
+
+The agent runs `/burnwatch-interview` — a conversational flow that walks through each detected service one at a time, confirms plans, sets budgets, and configures API keys. No terminal commands needed.
+
+**From the terminal:**
 
 ```bash
-# 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
+burnwatch init     # interactive interview in TTY mode
+```
 
-# CALC tracking - flat-rate services
-burnwatch add posthog --plan-cost 0 --budget 0
-burnwatch add inngest --plan-cost 25 --budget 25
+**Manual CLI (if you prefer):**
 
-# Just set a budget (tracking stays at detected tier)
-burnwatch add browserbase --budget 75
+```bash
+burnwatch add anthropic --key $ANTHROPIC_ADMIN_KEY --budget 100
+burnwatch add scrapfly --key $SCRAPFLY_KEY --budget 50
+burnwatch configure --service posthog --plan "Free" --budget 0
 ```
 
 API keys are stored in `~/.config/burnwatch/` (global, `chmod 600`). They **never** touch your project directory. They never end up in git.
@@ -229,12 +237,51 @@ This feedback loop doesn't exist anywhere else today. The agent has cost memory.
 
 <br>
 
+## Claude Code Setup
+
+burnwatch is designed to work natively with Claude Code. When you run `npx burnwatch init`, it:
+
+1. **Detects** all paid services in your project
+2. **Copies hooks** to `.burnwatch/hooks/` (session start, prompt submit, file change, stop)
+3. **Installs skills** to `.claude/skills/` — three agent skills become available:
+   - `/setup-burnwatch` — Guided onboarding that walks you through configuring all services
+   - `/burnwatch-interview` — Conversational interview that confirms plans, budgets, and API keys one service at a time
+   - `/spend` — Quick spend check (or `/spend scrapfly` for a specific service)
+4. **Registers hooks** in `.claude/settings.json`
+
+### Agent-driven configuration
+
+Instead of running CLI commands manually, let the agent interview you:
+
+```
+You: "Let's configure burnwatch"
+
+Agent: I found 11 services in your project. Let me walk through each one.
+
+      First — Anthropic. Defaulted to "API Usage" at $100/mo.
+      I checked your API — you've spent $47.23 this month.
+      Does $100/mo feel right, or want to adjust?
+
+You: That's good, keep it.
+
+Agent: Got it — Anthropic set to $100/mo. ✅
+
+      Next — Scrapfly. Probe detected Pro plan, 250K/1M credits used.
+      Keep the $100/mo budget?
+```
+
+The agent works through services by risk category (LLMs first, then usage-based, then infrastructure), batches free-tier services together, and writes each answer back immediately via `burnwatch configure`.
+
+<br>
+
 ## CLI Reference
 
 ```
 burnwatch init                              Initialize in current project
 burnwatch setup                             Init + auto-configure all detected services
 burnwatch add <service> [options]           Register a service for tracking
+burnwatch configure [options]               Update service config (plan, budget, key)
+burnwatch interview --json                  Export current state as JSON (for agent use)
 burnwatch status                            Show current spend brief
 burnwatch services                          List all services in registry
 burnwatch reconcile                         Scan for untracked services
@@ -251,6 +298,16 @@ burnwatch version                           Show version
 | `--budget <N>` | Monthly budget in USD |
 | `--plan-cost <N>` | Monthly plan cost for CALC tracking |
 
+### `burnwatch configure` options
+
+| Flag | Description |
+|------|-------------|
+| `--service <ID>` | Service to configure (e.g., `anthropic`, `scrapfly`) |
+| `--plan <NAME>` | Set the plan tier |
+| `--budget <N>` | Set monthly budget in USD |
+| `--key <KEY>` | Set API key for LIVE tracking |
+| `--exclude` | Exclude service from tracking |
+
 <br>
 
 ## Config Model

package/dist/cli.js

@@ -767,13 +767,151 @@ var scrapflyConnector = {
   }
 };
 
+// src/services/supabase.ts
+init_base();
+var supabaseConnector = {
+  serviceId: "supabase",
+  async fetchSpend(token) {
+    const orgsResult = await fetchJson("https://api.supabase.com/v1/organizations", {
+      headers: {
+        Authorization: `Bearer ${token}`
+      }
+    });
+    if (!orgsResult.ok || !orgsResult.data) {
+      return {
+        serviceId: "supabase",
+        spend: 0,
+        isEstimate: true,
+        tier: "est",
+        error: orgsResult.error ?? "Failed to fetch Supabase orgs \u2014 is this a PAT (not service_role key)?"
+      };
+    }
+    const org = orgsResult.data[0];
+    if (!org?.id) {
+      return {
+        serviceId: "supabase",
+        spend: 0,
+        isEstimate: true,
+        tier: "est",
+        error: "No Supabase organization found"
+      };
+    }
+    const planName = org.billing?.plan ?? "unknown";
+    const planCosts = {
+      free: 0,
+      pro: 25,
+      team: 599,
+      enterprise: 0
+      // custom pricing
+    };
+    const baseCost = planCosts[planName.toLowerCase()] ?? 0;
+    let totalSpend = baseCost;
+    const usageResult = await fetchJson(`https://api.supabase.com/v1/organizations/${org.id}/usage`, {
+      headers: {
+        Authorization: `Bearer ${token}`
+      }
+    });
+    if (usageResult.ok && usageResult.data) {
+      if (usageResult.data.usage) {
+        const overageCost = usageResult.data.usage.reduce(
+          (sum, item) => sum + (item.cost ?? 0),
+          0
+        );
+        if (overageCost > 0) totalSpend = baseCost + overageCost;
+      } else if (usageResult.data.total_usage !== void 0) {
+        totalSpend = usageResult.data.total_usage;
+      }
+    }
+    return {
+      serviceId: "supabase",
+      spend: totalSpend,
+      isEstimate: false,
+      tier: "live",
+      raw: {
+        plan: planName,
+        base_cost: baseCost,
+        org_id: org.id,
+        org_name: org.name,
+        ...usageResult.data ?? {}
+      }
+    };
+  }
+};
+
+// src/services/browserbase.ts
+init_base();
+var browserbaseConnector = {
+  serviceId: "browserbase",
+  async fetchSpend(apiKey) {
+    const projectsResult = await fetchJson("https://api.browserbase.com/v1/projects", {
+      headers: {
+        "X-BB-API-Key": apiKey
+      }
+    });
+    if (!projectsResult.ok || !projectsResult.data) {
+      return {
+        serviceId: "browserbase",
+        spend: 0,
+        isEstimate: true,
+        tier: "est",
+        error: projectsResult.error ?? "Failed to fetch Browserbase projects"
+      };
+    }
+    const project = projectsResult.data[0];
+    if (!project?.id) {
+      return {
+        serviceId: "browserbase",
+        spend: 0,
+        isEstimate: true,
+        tier: "est",
+        error: "No Browserbase project found"
+      };
+    }
+    const usageResult = await fetchJson(`https://api.browserbase.com/v1/projects/${project.id}/usage`, {
+      headers: {
+        "X-BB-API-Key": apiKey
+      }
+    });
+    if (!usageResult.ok || !usageResult.data) {
+      return {
+        serviceId: "browserbase",
+        spend: 0,
+        isEstimate: true,
+        tier: "est",
+        error: "Projects found but usage endpoint failed"
+      };
+    }
+    const minutes = usageResult.data.total_minutes ?? usageResult.data.usage?.minutes ?? (usageResult.data.total_hours ?? usageResult.data.usage?.hours ?? 0) * 60;
+    const sessionCount = usageResult.data.total_sessions ?? usageResult.data.usage?.sessions ?? 0;
+    const minuteRate = 0.1;
+    const spend = minutes * minuteRate;
+    return {
+      serviceId: "browserbase",
+      spend,
+      isEstimate: true,
+      // rate may vary by plan
+      tier: "est",
+      unitsUsed: sessionCount,
+      unitName: "sessions",
+      raw: {
+        minutes,
+        sessions: sessionCount,
+        minute_rate: minuteRate,
+        ...usageResult.data
+      }
+    };
+  }
+};
+
 // src/services/index.ts
 init_base();
 var connectors = /* @__PURE__ */ new Map([
   ["anthropic", anthropicConnector],
   ["openai", openaiConnector],
   ["vercel", vercelConnector],
-  ["scrapfly", scrapflyConnector]
+  ["scrapfly", scrapflyConnector],
+  ["supabase", supabaseConnector],
+  ["browserbase", browserbaseConnector]
 ]);
 async function pollService(tracked) {
   const globalConfig = readGlobalConfig();
@@ -862,7 +1000,7 @@ function formatBrief(brief) {
   );
   lines.push(`\u2551  ${hrSingle}  \u2551`);
   for (const svc of brief.services) {
-    const spendStr = svc.isEstimate ? `~$${svc.spend.toFixed(2)}` : `$${svc.spend.toFixed(2)}`;
+    const spendStr = svc.tier === "blind" && svc.spend === 0 ? "\u2014" : svc.isEstimate ? `~$${svc.spend.toFixed(2)}` : `$${svc.spend.toFixed(2)}`;
     const badge = CONFIDENCE_BADGES[svc.tier];
     const budgetStr = svc.budget ? `$${svc.budget}` : "\u2014";
     const leftStr = formatLeft(svc);
@@ -880,7 +1018,7 @@ function formatBrief(brief) {
   lines.push(`\u2560${hrDouble}\u2563`);
   const totalStr = brief.totalIsEstimate ? `~$${brief.totalSpend.toFixed(2)}` : `$${brief.totalSpend.toFixed(2)}`;
   const marginStr = brief.estimateMargin > 0 ? `  Est margin: \xB1$${brief.estimateMargin.toFixed(0)}` : "";
-  const untrackedStr = brief.untrackedCount > 0 ? `Untracked: ${brief.untrackedCount} \u26A0\uFE0F` : `Untracked: 0 \u2705`;
+  const untrackedStr = brief.untrackedCount > 0 ? `No billing data: ${brief.untrackedCount} \u26A0\uFE0F` : `All tracked \u2705`;
   lines.push(
     `\u2551  TOTAL: ${totalStr}   ${untrackedStr}${marginStr}`.padEnd(
       width + 1
@@ -931,7 +1069,7 @@ function buildBrief(projectName, snapshots, blindCount) {
     alerts.push({
       serviceId: "_blind",
       type: "blind_service",
-      message: `${blindCount} service${blindCount > 1 ? "s" : ""} detected but untracked - run 'burnwatch init' to configure`,
+      message: `${blindCount} service${blindCount > 1 ? "s" : ""} have no billing data \u2014 add API keys for live tracking`,
       severity: "warning"
     });
   }
@@ -964,7 +1102,7 @@ function buildSnapshot(serviceId, tier, spend, budget, allowanceData) {
   const isEstimate = tier === "est" || tier === "calc";
   const budgetPercent = budget ? spend / budget * 100 : void 0;
   let status = "unknown";
-  let statusLabel = "no budget";
+  let statusLabel = tier === "blind" ? "needs API key" : "no budget";
   if (budget) {
     if (budgetPercent > 100) {
       status = "over";
@@ -1510,10 +1648,16 @@ async function cmdInit() {
   console.log("\n\u{1F517} Registering Claude Code hooks...\n");
   registerHooks(projectRoot);
   console.log("\nburnwatch initialized.\n");
-  console.log("Next steps:");
-  console.log("  burnwatch status        Show current spend");
-  console.log("  burnwatch add <svc>     Update a service's budget or API key");
-  console.log("  burnwatch init          Re-run this setup anytime\n");
+  if (process.stdin.isTTY) {
+    console.log("Next steps:");
+    console.log("  burnwatch status        Show current spend");
+    console.log("  burnwatch add <svc>     Update a service's budget or API key");
+    console.log("  burnwatch init          Re-run this setup anytime\n");
+  } else {
+    console.log("Next steps:");
+    console.log("  Ask your agent to run /burnwatch-interview for guided setup");
+    console.log("  Or run 'burnwatch status' to see current spend\n");
+  }
 }
 async function cmdInterview() {
   const projectRoot = process.cwd();
@@ -1744,16 +1888,27 @@ async function cmdConfigure() {
   }
   config.services[serviceId] = tracked;
   writeProjectConfig(config, projectRoot);
+  const connectorServices = ["anthropic", "openai", "vercel", "scrapfly", "supabase", "browserbase"];
+  const hasConnector = connectorServices.includes(serviceId);
   let tier = "blind";
-  if (tracked.excluded) tier = "excluded";
-  else if (tracked.hasApiKey) tier = "live";
-  else if (tracked.planCost !== void 0) tier = "calc";
+  let tierNote = null;
+  if (tracked.excluded) {
+    tier = "excluded";
+  } else if (tracked.hasApiKey && hasConnector) {
+    tier = "live";
+  } else if (tracked.hasApiKey && !hasConnector) {
+    tier = "calc";
+    tierNote = `Key saved but ${serviceId} has no billing connector yet \u2014 tracking as CALC. The key will be used for probing during interviews.`;
+  } else if (tracked.planCost !== void 0) {
+    tier = "calc";
+  }
   const result = {
     success: true,
     serviceId,
     plan: tracked.planName ?? null,
     budget: tracked.budget ?? null,
     tier,
+    tierNote,
     hasApiKey: tracked.hasApiKey,
     allowance: tracked.allowance ?? null
   };
@@ -1858,12 +2013,12 @@ async function cmdStatus() {
   console.log(formatBrief(brief));
   console.log("");
   if (blindCount > 0) {
-    console.log(`\u26A0\uFE0F  ${blindCount} service${blindCount > 1 ? "s" : ""} untracked:`);
+    console.log(`\u26A0\uFE0F  ${blindCount} service${blindCount > 1 ? "s" : ""} with no billing data:`);
     for (const snap of snapshots.filter((s) => s.tier === "blind")) {
-      console.log(`   \u2022 ${snap.serviceId}`);
+      console.log(`   \u2022 ${snap.serviceId} \u2014 add an API key for live tracking`);
     }
     console.log(`
-   Run 'burnwatch init' to configure budgets and API keys.
+   Run 'burnwatch configure --service <id> --key <KEY>' to enable live billing.
 `);
   }
 }
@@ -1987,6 +2142,26 @@ function registerHooks(projectRoot) {
     }
   }
   console.log(`   Hook scripts copied to ${localHooksDir}`);
+  const sourceSkillsDir = path5.resolve(
+    path5.dirname(new URL(import.meta.url).pathname),
+    "../skills"
+  );
+  const skillNames = ["setup-burnwatch", "burnwatch-interview", "spend"];
+  const claudeSkillsDir = path5.join(projectRoot, ".claude", "skills");
+  for (const skillName of skillNames) {
+    const srcSkill = path5.join(sourceSkillsDir, skillName, "SKILL.md");
+    const destDir = path5.join(claudeSkillsDir, skillName);
+    const destSkill = path5.join(destDir, "SKILL.md");
+    try {
+      if (fs5.existsSync(srcSkill)) {
+        fs5.mkdirSync(destDir, { recursive: true });
+        fs5.copyFileSync(srcSkill, destSkill);
+      }
+    } catch (err) {
+      console.error(`   Warning: Could not copy skill ${skillName}: ${err instanceof Error ? err.message : err}`);
+    }
+  }
+  console.log(`   Skills installed to ${claudeSkillsDir}`);
   const claudeDir = path5.join(projectRoot, ".claude");
   const settingsPath = path5.join(claudeDir, "settings.json");
   fs5.mkdirSync(claudeDir, { recursive: true });