claudectx 1.1.1 → 1.1.2

package/README.md

@@ -269,14 +269,17 @@ Output shows per-file token counts, cache hit likelihood (based on your recent r
 Start each session with a cache hit instead of a full miss. Sends a silent priming request to Anthropic so your CLAUDE.md is cached before Claude Code touches it.
 
 ```bash
-claudectx warmup --api-key $ANTHROPIC_API_KEY         # 5-min cache TTL (default)
-claudectx warmup --ttl 60 --api-key $ANTHROPIC_API_KEY  # 60-min extended TTL
-claudectx warmup --cron "0 9 * * 1-5" --api-key ...  # Install as daily cron job
-claudectx warmup --json                               # Output result as JSON
+claudectx warmup --api-key $ANTHROPIC_API_KEY          # 5-min cache TTL (default)
+claudectx warmup --ttl 60 --api-key $ANTHROPIC_API_KEY # 60-min extended TTL (2× write cost)
+claudectx warmup --model sonnet --api-key $ANTHROPIC_API_KEY  # use a specific model
+claudectx warmup --cron "0 9 * * 1-5"                 # Install as weekday 9am cron job
+claudectx warmup --json                                # JSON output for scripting
 ```
 
 Reports tokens warmed, write cost, savings per cache hit, and break-even request count.
 
+> **Note on `--cron`:** The API key is **not** embedded in the cron job. At runtime, the job reads `ANTHROPIC_API_KEY` from your environment. Set it in `~/.profile` or `~/.zshenv` so cron can see it.
+
 ---
 
 ### `claudectx drift` — CLAUDE.md stays fresh, not stale
@@ -286,8 +289,9 @@ Over time CLAUDE.md accumulates dead references and sections nobody reads. `drif
 ```bash
 claudectx drift                      # Scan current project
 claudectx drift --days 14            # Use 14-day read window (default: 30)
-claudectx drift --fix                # Interactively remove flagged lines
+claudectx drift --fix                # Interactively remove flagged lines (creates CLAUDE.md.bak first)
 claudectx drift --json               # JSON output
+claudectx drift --path /other/proj  # Scan a different project directory
 ```
 
 Detects 4 types of drift:
@@ -306,20 +310,24 @@ Detects 4 types of drift:
 Install named, pre-configured hooks beyond the basic read logger.
 
 ```bash
-claudectx hooks list                                  # Show all available hooks
-claudectx hooks add auto-compress --config apiKey=sk-...  # Install a hook
-claudectx hooks remove slack-digest                   # Remove an installed hook
-claudectx hooks status                                # Show what's installed
+claudectx hooks list                                        # Show all available hooks
+claudectx hooks add auto-compress                           # Install with default threshold (50k tokens)
+claudectx hooks add auto-compress --config threshold=30000  # Custom token threshold
+claudectx hooks add slack-digest --config webhookUrl=https://hooks.slack.com/...
+claudectx hooks remove slack-digest                         # Remove an installed hook
+claudectx hooks status                                      # Show what's installed
 ```
 
 **Built-in hooks:**
 
-| Hook | Trigger | What it does |
-|---|---|---|
-| `auto-compress` | PostToolUse (Read) | Runs `claudectx compress` after each session |
-| `daily-budget` | PreToolUse | Checks token budget before each tool call |
-| `slack-digest` | Stop | Posts session report to a Slack webhook |
-| `session-warmup` | PostToolUse (Read) | Re-warms the cache after each read |
+| Hook | Trigger | Config | What it does |
+|---|---|---|---|
+| `auto-compress` | PostToolUse (Read) | `threshold` (default: 50000) | Runs `claudectx compress` after each session |
+| `daily-budget` | PreToolUse | _(none)_ | Reports today's spend before each tool call |
+| `slack-digest` | Stop | `webhookUrl` (required) | Posts session report to a Slack webhook |
+| `session-warmup` | PostToolUse (Read) | _(none)_ | Re-warms the cache; reads `ANTHROPIC_API_KEY` from env |
+
+> **Security note:** Hooks that need an API key (`compress`, `warmup`) read `ANTHROPIC_API_KEY` from your environment — no secrets are stored in `.claude/settings.local.json`.
 
 ---
 
@@ -344,16 +352,16 @@ See where the money goes across your whole team — without sharing session cont
 
 ```bash
 # Step 1: each developer runs this on their own machine
-claudectx teams export
+claudectx teams export                           # Default: last 30 days, sonnet pricing
+claudectx teams export --days 7 --model haiku   # Custom window and model
 
 # Step 2: collect the JSON files in a shared directory, then aggregate
 claudectx teams aggregate --dir ./reports/
+claudectx teams aggregate --dir ./reports/ --anonymize  # Replace names with Dev 1, Dev 2...
+claudectx teams aggregate --dir ./reports/ --json       # Machine-readable JSON
 
 # Optional: copy your export to a shared location
 claudectx teams share --to /shared/reports/
-
-# Anonymize for review
-claudectx teams aggregate --dir ./reports/ --anonymize
 ```
 
 Output shows per-developer spend, cache hit rate, avg request size, and top shared files. Exports are lightweight JSON — no session content, no prompts, just aggregated token counts.

package/dist/index.js

@@ -239,7 +239,7 @@ function findSessionFile(sessionId) {
   }
   return files[0]?.filePath ?? null;
 }
-function readSessionUsage(sessionFilePath) {
+async function readSessionUsage(sessionFilePath) {
   const result = {
     inputTokens: 0,
     outputTokens: 0,
@@ -248,28 +248,32 @@ function readSessionUsage(sessionFilePath) {
     requestCount: 0
   };
   if (!fs9.existsSync(sessionFilePath)) return result;
-  let content;
+  const { createReadStream } = await import("fs");
+  const { createInterface } = await import("readline");
   try {
-    content = fs9.readFileSync(sessionFilePath, "utf-8");
-  } catch {
-    return result;
-  }
-  const lines = content.trim().split("\n").filter(Boolean);
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-      const usage = entry.usage ?? entry.message?.usage;
-      if (!usage) continue;
-      const isAssistant = entry.type === "assistant" || entry.message?.role === "assistant";
-      if (isAssistant) {
-        result.inputTokens += usage.input_tokens ?? 0;
-        result.outputTokens += usage.output_tokens ?? 0;
-        result.cacheCreationTokens += usage.cache_creation_input_tokens ?? 0;
-        result.cacheReadTokens += usage.cache_read_input_tokens ?? 0;
-        result.requestCount++;
+    const rl = createInterface({
+      input: createReadStream(sessionFilePath, { encoding: "utf-8" }),
+      crlfDelay: Infinity
+    });
+    for await (const line of rl) {
+      if (!line.trim()) continue;
+      try {
+        const entry = JSON.parse(line);
+        const usage = entry.usage ?? entry.message?.usage;
+        if (!usage) continue;
+        const isAssistant = entry.type === "assistant" || entry.message?.role === "assistant";
+        if (isAssistant) {
+          result.inputTokens += usage.input_tokens ?? 0;
+          result.outputTokens += usage.output_tokens ?? 0;
+          result.cacheCreationTokens += usage.cache_creation_input_tokens ?? 0;
+          result.cacheReadTokens += usage.cache_read_input_tokens ?? 0;
+          result.requestCount++;
+        }
+      } catch {
       }
-    } catch {
     }
+  } catch {
+    return result;
   }
   return result;
 }
@@ -397,20 +401,23 @@ function Dashboard({
     const events = readAllEvents();
     const fileStats2 = aggregateStats(events);
     const sessionFile2 = sessionId ? findSessionFile(sessionId) : findSessionFile();
-    const usage2 = sessionFile2 ? readSessionUsage(sessionFile2) : {
+    const usagePromise = sessionFile2 ? readSessionUsage(sessionFile2) : Promise.resolve({
       inputTokens: 0,
       outputTokens: 0,
       cacheCreationTokens: 0,
       cacheReadTokens: 0,
       requestCount: 0
-    };
-    setState((prev) => ({
-      fileStats: fileStats2,
-      usage: usage2,
-      sessionFile: sessionFile2,
-      lastUpdated: /* @__PURE__ */ new Date(),
-      tickCount: prev.tickCount + 1
-    }));
+    });
+    usagePromise.then((usage2) => {
+      setState((prev) => ({
+        fileStats: fileStats2,
+        usage: usage2,
+        sessionFile: sessionFile2,
+        lastUpdated: /* @__PURE__ */ new Date(),
+        tickCount: prev.tickCount + 1
+      }));
+    }).catch(() => {
+    });
   }, [sessionId]);
   (0, import_react.useEffect)(() => {
     refresh();
@@ -2767,9 +2774,9 @@ init_models();
 function isoDate(d) {
   return d.toISOString().slice(0, 10);
 }
-function calcCost2(inputTokens, outputTokens, model) {
+function calcCost2(inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens, model) {
   const p = MODEL_PRICING[model];
-  return inputTokens / 1e6 * p.inputPerMillion + outputTokens / 1e6 * p.outputPerMillion;
+  return inputTokens / 1e6 * p.inputPerMillion + outputTokens / 1e6 * p.outputPerMillion + cacheCreationTokens / 1e6 * p.cacheWritePerMillion + cacheReadTokens / 1e6 * p.cacheReadPerMillion;
 }
 async function aggregateUsage(days, model = "claude-sonnet-4-6") {
   const now = /* @__PURE__ */ new Date();
@@ -2788,6 +2795,7 @@ async function aggregateUsage(days, model = "claude-sonnet-4-6") {
       inputTokens: 0,
       outputTokens: 0,
       cacheReadTokens: 0,
+      cacheCreationTokens: 0,
       requests: 0,
       costUsd: 0
     });
@@ -2796,20 +2804,23 @@ async function aggregateUsage(days, model = "claude-sonnet-4-6") {
   let totalInput = 0;
   let totalOutput = 0;
   let totalCacheRead = 0;
+  let totalCacheCreation = 0;
   for (const sf of sessionFiles) {
     const dateStr = isoDate(new Date(sf.mtimeMs));
     const bucket = bucketMap.get(dateStr);
     if (!bucket) continue;
-    const usage = readSessionUsage(sf.filePath);
+    const usage = await readSessionUsage(sf.filePath);
     bucket.sessions++;
     bucket.inputTokens += usage.inputTokens;
     bucket.outputTokens += usage.outputTokens;
     bucket.cacheReadTokens += usage.cacheReadTokens;
+    bucket.cacheCreationTokens += usage.cacheCreationTokens;
     bucket.requests += usage.requestCount;
-    bucket.costUsd += calcCost2(usage.inputTokens, usage.outputTokens, model);
+    bucket.costUsd += calcCost2(usage.inputTokens, usage.outputTokens, usage.cacheCreationTokens, usage.cacheReadTokens, model);
     totalInput += usage.inputTokens;
     totalOutput += usage.outputTokens;
     totalCacheRead += usage.cacheReadTokens;
+    totalCacheCreation += usage.cacheCreationTokens;
     totalRequests += usage.requestCount;
   }
   const fileEvents = readAllEvents().filter(
@@ -2820,10 +2831,12 @@ async function aggregateUsage(days, model = "claude-sonnet-4-6") {
     filePath: s.filePath,
     readCount: s.readCount
   }));
-  const totalCost = calcCost2(totalInput, totalOutput, model);
+  const totalCost = calcCost2(totalInput, totalOutput, totalCacheCreation, totalCacheRead, model);
   const cacheHitRate = totalInput > 0 ? Math.round(totalCacheRead / totalInput * 100) : 0;
   const byDay = [...bucketMap.values()].sort((a, b) => a.date.localeCompare(b.date));
   const uniqueSessions = new Set(sessionFiles.map((f) => f.sessionId)).size;
+  const dailyAvgCostUsd = days > 0 ? totalCost / days : 0;
+  const projectedMonthlyUsd = dailyAvgCostUsd * 30;
   return {
     periodDays: days,
     startDate: isoDate(cutoff),
@@ -2833,10 +2846,13 @@ async function aggregateUsage(days, model = "claude-sonnet-4-6") {
     totalInputTokens: totalInput,
     totalOutputTokens: totalOutput,
     totalCacheReadTokens: totalCacheRead,
+    totalCacheCreationTokens: totalCacheCreation,
     cacheHitRate,
     totalCostUsd: totalCost,
     avgCostPerSession: uniqueSessions > 0 ? totalCost / uniqueSessions : 0,
     avgTokensPerRequest: totalRequests > 0 ? Math.round(totalInput / totalRequests) : 0,
+    dailyAvgCostUsd,
+    projectedMonthlyUsd,
     byDay,
     topFiles,
     model,
@@ -2879,9 +2895,12 @@ function formatText(data) {
   lines.push(`  Input tokens:          ${fmtNum2(data.totalInputTokens)}`);
   lines.push(`  Output tokens:         ${fmtNum2(data.totalOutputTokens)}`);
   lines.push(`  Cache reads:           ${fmtNum2(data.totalCacheReadTokens)}  (${data.cacheHitRate}% hit rate)`);
+  lines.push(`  Cache writes:          ${fmtNum2(data.totalCacheCreationTokens)}`);
   lines.push(`  Total cost (est.):     ${fmtCost2(data.totalCostUsd)}`);
   lines.push(`  Avg cost/session:      ${fmtCost2(data.avgCostPerSession)}`);
   lines.push(`  Avg tokens/request:    ${fmtNum2(data.avgTokensPerRequest)}`);
+  lines.push(`  Daily avg cost:        ${fmtCost2(data.dailyAvgCostUsd)}`);
+  lines.push(`  Projected (30-day):    ${fmtCost2(data.projectedMonthlyUsd)}`);
   lines.push(`  Model:                 ${data.model}`);
   lines.push("");
   const activeDays = data.byDay.filter((d) => d.sessions > 0);
@@ -2950,9 +2969,12 @@ function formatMarkdown(data) {
   lines.push(`| Input tokens | ${fmtNum2(data.totalInputTokens)} |`);
   lines.push(`| Output tokens | ${fmtNum2(data.totalOutputTokens)} |`);
   lines.push(`| Cache hit rate | ${data.cacheHitRate}% |`);
+  lines.push(`| Cache writes | ${fmtNum2(data.totalCacheCreationTokens)} tokens |`);
   lines.push(`| Total cost (est.) | ${fmtCost2(data.totalCostUsd)} |`);
   lines.push(`| Avg cost/session | ${fmtCost2(data.avgCostPerSession)} |`);
   lines.push(`| Avg tokens/request | ${fmtNum2(data.avgTokensPerRequest)} |`);
+  lines.push(`| Daily avg cost | ${fmtCost2(data.dailyAvgCostUsd)} |`);
+  lines.push(`| Projected (30-day) | ${fmtCost2(data.projectedMonthlyUsd)} |`);
   lines.push(`| Model | \`${data.model}\` |`);
   lines.push("");
   const activeDays = data.byDay.filter((d) => d.sessions > 0);
@@ -4100,9 +4122,9 @@ function getDeveloperIdentity() {
   }
   return os4.hostname();
 }
-function calcCost3(inputTokens, outputTokens, model) {
+function calcCost3(inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens, model) {
   const p = MODEL_PRICING[model];
-  return inputTokens / 1e6 * p.inputPerMillion + outputTokens / 1e6 * p.outputPerMillion;
+  return inputTokens / 1e6 * p.inputPerMillion + outputTokens / 1e6 * p.outputPerMillion + cacheCreationTokens / 1e6 * p.cacheWritePerMillion + cacheReadTokens / 1e6 * p.cacheReadPerMillion;
 }
 function isoDate2(d) {
   return d.toISOString().slice(0, 10);
@@ -4133,6 +4155,7 @@ async function buildTeamExport(days, model, anonymize) {
       inputTokens: 0,
       outputTokens: 0,
       cacheReadTokens: 0,
+      cacheCreationTokens: 0,
       requests: 0,
       costUsd: 0
     });
@@ -4144,14 +4167,15 @@ async function buildTeamExport(days, model, anonymize) {
   for (const sf of sessionFiles) {
     const dateStr = isoDate2(new Date(sf.mtimeMs));
     const bucket = bucketMap.get(dateStr);
-    const usage = readSessionUsage(sf.filePath);
+    const usage = await readSessionUsage(sf.filePath);
     if (bucket) {
       bucket.sessions++;
       bucket.inputTokens += usage.inputTokens;
       bucket.outputTokens += usage.outputTokens;
       bucket.cacheReadTokens += usage.cacheReadTokens;
+      bucket.cacheCreationTokens += usage.cacheCreationTokens;
       bucket.requests += usage.requestCount;
-      bucket.costUsd += calcCost3(usage.inputTokens, usage.outputTokens, model);
+      bucket.costUsd += calcCost3(usage.inputTokens, usage.outputTokens, usage.cacheCreationTokens, usage.cacheReadTokens, model);
     }
     totalInput += usage.inputTokens;
     totalOutput += usage.outputTokens;
@@ -4162,7 +4186,7 @@ async function buildTeamExport(days, model, anonymize) {
     (e) => new Date(e.timestamp).getTime() >= cutoffMs
   );
   const topWasteFiles = aggregateStats(fileEvents).slice(0, 10).map((s) => ({ filePath: s.filePath, readCount: s.readCount }));
-  const totalCostUsd = calcCost3(totalInput, totalOutput, model);
+  const totalCostUsd = calcCost3(totalInput, totalOutput, 0, totalCacheRead, model);
   const cacheHitRate = totalInput > 0 ? Math.round(totalCacheRead / totalInput * 100) : 0;
   const uniqueSessions = new Set(sessionFiles.map((f) => f.sessionId)).size;
   const developer = {
@@ -4378,7 +4402,7 @@ async function teamsCommand(subcommand, options) {
 }
 
 // src/index.ts
-var VERSION = "1.0.0";
+var VERSION = "1.1.2";
 var DESCRIPTION = "Reduce Claude Code token usage by up to 80%. Context analyzer, auto-optimizer, live dashboard, and smart MCP tools.";
 var program = new import_commander.Command();
 program.name("claudectx").description(DESCRIPTION).version(VERSION);