ai-usage-analyzer 0.2.0 → 0.3.0

package/README.md

@@ -17,60 +17,13 @@ TUI analyzer for local AI coding agent token consumption. Auto-detects
 
 Requires **Node.js ≥ 22.5** (for built-in `node:sqlite`).
 
-Pick whichever fits your workflow:
-
-### Option 1: `npx` from GitHub (zero install, fastest to try)
-
 ```bash
+# Try it (no install)
 npx -y github:adetxt/ai-usage-analyzer
-# or with a specific ref
-npx -y github:adetxt/ai-usage-analyzer#v0.1.0
-```
-
-No clone, no `node_modules`, no global install. npx downloads the repo
-on first run and caches it. Subsequent runs are instant.
 
-### Option 2: Clone + install (best for development / contribution)
-
-```bash
-git clone https://github.com/adetxt/ai-usage-analyzer.git
-cd ai-usage-analyzer
-pnpm install
-pnpm link --global   # exposes the `ai-usage` command globally
-```
-
-> Uses `pnpm` (declared in the `packageManager` field). `pnpm-lock.yaml`
-> is committed as the source of truth for reproducible installs.
-
-### Option 3: Install globally from GitHub (no clone)
-
-```bash
+# Or install globally
 pnpm add -g git+https://github.com/adetxt/ai-usage-analyzer.git
-# or with npm
-npm install -g git+https://github.com/adetxt/ai-usage-analyzer.git
-# then
-ai-usage
-```
-
-### Option 4: From npm registry (when published)
-
-```bash
-npx -y ai-usage-analyzer
-# or
-pnpm add -g ai-usage-analyzer
-```
-
-To publish your own copy: `npm login && npm publish --access public`
-(requires the `ai-usage-analyzer` name to be available on npmjs.com,
-or use a scoped name like `@yourname/ai-usage-analyzer` and update
-the `name` field in `package.json` first).
-
-### Verify install
-
-```bash
 ai-usage --help
-# or via npx
-npx -y github:adetxt/ai-usage-analyzer --help
 ```
 
 ## Usage
@@ -78,139 +31,48 @@ npx -y github:adetxt/ai-usage-analyzer --help
 ```bash
 ai-usage                  # default TUI
 ai-usage --top 10         # show top 10 heaviest sessions
-ai-usage --json           # machine-readable JSON output
-ai-usage --markdown       # GitHub-flavored Markdown report
-ai-usage --md > report.md # same, save to file
-ai-usage -h               # help (also --help)
+ai-usage --json           # machine-readable JSON
+ai-usage --md > report.md # save as markdown
 ```
 
-### Environment overrides
+## Supported tools
 
-If a tool's data lives outside the default location, override its base path:
+| Tool | Default path | Tokens |
+|---|---|---|
+| Claude Code    | `~/.claude/projects`                | presence only |
+| Codex          | `~/.codex/sessions/YYYY/MM/DD/`    | yes |
+| OpenCode       | `~/.local/share/opencode/opencode.db` | yes (+cost) |
+| MimoCode       | `~/.local/share/mimocode/mimocode.db` | yes (+cost) |
+| GitHub Copilot | `~/.copilot/session-state/`        | presence only |
+| Antigravity    | `~/Library/Application Support/Antigravity` | presence only |
+| Gemini CLI     | `~/.gemini/antigravity/conversations` | presence only |
 
-```bash
-export CLAUDE_HOME=/custom/path/to/.claude
-export CODEX_HOME=/custom/path/to/.codex
-export OPENCODE_HOME=/custom/path/to/.local/share/opencode
-export MIMOCODE_HOME=/custom/path/to/.local/share/mimocode
-export COPILOT_HOME=/custom/path/to/.copilot
-export ANTIGRAVITY_HOME=/custom/path/to/Antigravity
-export GEMINI_HOME=/custom/path/to/.gemini
-```
+## Path overrides
 
-Or pass all at once via JSON:
+Override any tool's base path with an env var (`CLAUDE_HOME`, `CODEX_HOME`,
+`OPENCODE_HOME`, `MIMOCODE_HOME`, `COPILOT_HOME`, `ANTIGRAVITY_HOME`,
+`GEMINI_HOME`), or pass all at once via JSON:
 
 ```bash
 export AI_USAGE_PATHS_JSON='{"codex":"/data/codex","opencode":"/data/oc.db"}'
 ```
 
-## Supported tools
-
-| Tool | Path | Token data | Source format |
-|---|---|---|---|
-| Claude Code    | `~/.claude/transcripts`             | presence only | `ses_*.jsonl` |
-| Codex          | `~/.codex/sessions/YYYY/MM/DD/`    | **yes** | `rollout-*.jsonl` `token_count` events |
-| OpenCode       | `~/.local/share/opencode/opencode.db` | **yes** (+cost) | SQLite |
-| MimoCode       | `~/.local/share/mimocode/mimocode.db` | **yes** (+cost, when present) | SQLite |
-| GitHub Copilot | `~/.copilot/session-state/`        | presence only | `events.jsonl` |
-| Antigravity    | `~/Library/Application Support/Antigravity` | presence only | dir scan |
-| Gemini CLI     | `~/.gemini/antigravity/conversations` | presence only | `*.pb` protobuf |
-
 ## Token breakdown
 
-For tools that record token data, the analyzer shows the full breakdown:
+For tools that record token data, the analyzer shows input, output, cache
+read, cache write, and reasoning tokens. Cache hits are cheap; reasoning is
+the extended-thinking/chain-of-thought cost.
 
-- **Input** — prompt tokens sent to the model
-- **Output** — completion tokens generated by the model
-- **Cache Read** — prompt tokens served from the provider's cache (cheap)
-- **Cache Write** — prompt tokens cached for future use (OpenCode only)
-- **Reasoning** — extended thinking / chain-of-thought tokens
-
-The TUI is adaptive: at terminal widths below 110 columns it drops
-non-essential columns; at 110+ it shows the full breakdown with project
-paths, per-tool token columns, and longer distribution bars.
-
-## Architecture
+## How it works
 
 ```
 src/
-├── detectors.js    auto-path discovery (env → well-known locations)
-├── loaders.js      SQLite + JSONL parsers → unified session record
-├── aggregate.js    per-project / per-week / per-month grouping
-├── render.js       TUI (chalk + cli-table3 + boxen + gradient-string)
+├── detectors.js   auto-path discovery (env → well-known locations)
+├── loaders.js     SQLite + JSONL parsers → unified session record
+├── aggregate.js   per-project / per-week / per-month grouping
+├── render.js      TUI  •  markdown.js  →  Markdown report
 bin/
-└── ai-usage.js     entry point
-```
-
-The loader produces a unified record shape:
-
-```ts
-{
-  tool, sessionId, project, title, week, month, ts,
-  tokensInput, tokensOutput, tokensCacheRead, tokensCacheWrite,
-  tokensReasoning, tokensTotal, cost, model
-}
-```
-
-The aggregator then groups by project / week / month, and the renderer
-turns each grouping into a colored table with a distribution bar.
-
-## Output modes
-
-### TUI (default)
-
-Color-coded, boxed tables with bar charts. Adapts to terminal width.
-
-### JSON (`--json`)
-
-Single JSON object with detection results, summary, raw sessions, and errors.
-Suitable for piping into `jq` or feeding a dashboard.
-
-```bash
-ai-usage --json | jq '.summary'
-# {
-#   "n": 411,
-#   "tokensTotal": 1558000000,
-#   "tokensInput": 420900000,
-#   "tokensOutput": 4450000,
-#   "tokensCacheRead": 1130000000,
-#   "tokensCacheWrite": 49000,
-#   "tokensReasoning": 2210000,
-#   "cost": 29.4,
-#   "avg": 3790000
-# }
-```
-
-### Markdown (`--markdown` / `--md`)
-
-GitHub-flavored markdown report with the same sections as the TUI (header,
-detected tools, overview, token breakdown, per-project, per-month, per-week,
-top sessions, notes). Designed to be pasted into GitHub issues, PRs, or
-Notion pages.
-
-```bash
-ai-usage --md > report.md
-cat report.md   # or just paste the output into a GitHub comment
-```
-
-Distribution bars use Unicode block characters (`█░`) so they render in
-plain markdown without colors. Sample output:
-
-```markdown
-# AI Token Usage Report
-
-**Range**: 2026-04-01 → 2026-06-27  
-**Sessions**: 411  
-**Total tokens**: 1.58B  
-**Cost**: $29.40 (opencode only)  
-
-## Detected AI Tools
-
-| Tool | Status | Path | Count | Tokens |
-|---|---|---|---:|---|
-| Codex | ✅ present | `~/.codex/sessions` | 94 | ✅ |
-| OpenCode | ✅ present | `~/.local/share/opencode/opencode.db` | 328 | ✅ |
-| ...
+└── ai-usage.js    entry point
 ```
 
 ## License

package/bin/ai-usage.js

@@ -7,7 +7,8 @@ import { loadAll, dateRange } from '../src/loaders.js';
 import { overall } from '../src/aggregate.js';
 import {
   renderHeader, renderDetections, renderOverview,
-  renderPerProject, renderPerMonth, renderPerWeek,
+  renderPerProject, renderPerTool, renderPerToolPerMonth,
+  renderPerMonth, renderPerWeek,
   renderTopSessions, renderNotes,
 } from '../src/render.js';
 import { renderMarkdown } from '../src/markdown.js';
@@ -23,6 +24,12 @@ const topN = (() => {
   const v = parseInt(args[i + 1], 10);
   return Number.isFinite(v) && v > 0 ? v : 5;
 })();
+const yearFilter = (() => {
+  const i = args.indexOf('--year');
+  if (i < 0) return null;
+  const v = parseInt(args[i + 1], 10);
+  return Number.isFinite(v) && v > 1970 && v < 3000 ? v : null;
+})();
 
 if (showHelp) {
   console.log(`
@@ -36,9 +43,11 @@ Options:
   --json             Output machine-readable JSON instead of TUI
   --markdown, --md   Output as a Markdown report (GitHub-flavored tables)
   --top N            Show top N heaviest sessions (default: 5)
+  --year YYYY        Filter records to a single year (e.g. --year 2026)
 
 Examples:
   ai-usage                       # default TUI
+  ai-usage --year 2026           # TUI, only 2026 sessions
   ai-usage --json | jq .summary  # pipe to jq
   ai-usage --md > report.md      # save as markdown
   ai-usage --top 20              # show top 20 sessions
@@ -49,7 +58,7 @@ Environment overrides (per-tool data path):
   AI_USAGE_PATHS_JSON='{"codex":"/custom/path",...}'
 
 Supported tools:
-  • Claude Code    — ~/.claude/transcripts  (presence only)
+  • Claude Code    — ~/.claude/projects  (tokens from per-message usage)
   • Codex          — ~/.codex/sessions      (tokens from token_count events)
   • OpenCode       — ~/.local/share/opencode/opencode.db  (tokens + cost)
   • MimoCode       — ~/.local/share/mimocode/mimocode.db  (tokens + cost)
@@ -68,7 +77,14 @@ if (jsonOut && mdOut) {
 async function main() {
   const t0 = Date.now();
   const detections = detectAll();
-  const { records, errors } = await loadAll(detections);
+  const { records: allRecords, errors } = await loadAll(detections);
+
+  // Apply --year filter before any aggregation so dateRange and totals
+  // reflect the filtered set.
+  const records = yearFilter !== null
+    ? allRecords.filter(r => r.month && r.month.startsWith(`${yearFilter}-`))
+    : allRecords;
+
   const range = dateRange(records);
   const tot = overall(records);
 
@@ -78,6 +94,7 @@ async function main() {
       summary: tot,
       dateRange: range,
       sessions: records,
+      filter: yearFilter !== null ? { year: yearFilter } : null,
       errors,
       generatedAt: new Date().toISOString(),
       durationMs: Date.now() - t0,
@@ -109,6 +126,8 @@ async function main() {
     sections.push(
       renderOverview(records, detections),
       renderPerProject(records),
+      renderPerTool(records),
+      renderPerToolPerMonth(records),
       renderPerMonth(records),
       renderPerWeek(records),
       renderTopSessions(records, topN),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-usage-analyzer",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TUI analyzer for local AI coding agent token usage. Auto-detects Claude Code, Codex, OpenCode, MimoCode, Copilot, Antigravity, and Gemini.",
   "type": "module",
   "packageManager": "pnpm@10.33.0",

package/src/aggregate.js

@@ -2,8 +2,8 @@
 
 const MONTH_NAMES = {
   '01': 'Jan', '02': 'Feb', '03': 'Mar', '04': 'Apr',
-  '05': 'Mei', '06': 'Jun', '07': 'Jul', '08': 'Agu',
-  '09': 'Sep', '10': 'Okt', '11': 'Nov', '12': 'Des',
+  '05': 'May', '06': 'Jun', '07': 'Jul', '08': 'Aug',
+  '09': 'Sep', '10': 'Oct', '11': 'Nov', '12': 'Dec',
 };
 
 function sum(arr, key) {
@@ -38,13 +38,23 @@ function summarize(records) {
   };
 }
 
+function toolBreakdown(records) {
+  const byTool = {};
+  for (const r of records) {
+    byTool[r.tool] = (byTool[r.tool] || 0) + r.tokensTotal;
+  }
+  return byTool;
+}
+
 export function perProject(records) {
-  const m = groupBy(records, r => `${r.tool}\u0001${r.project}`);
+  // One row per project — tool mix is shown via the stacked bar / byTool,
+  // not as a separate column. Detailed per-tool-per-project breakdown
+  // is no longer surfaced here; the "Per Tool per Month" section is the
+  // place to see per-tool data over time.
+  const m = groupBy(records, r => r.project);
   const out = [];
-  for (const [k, arr] of m) {
-    const [tool, project] = k.split('\u0001');
-    const s = summarize(arr);
-    out.push({ tool, project, ...s });
+  for (const [project, arr] of m) {
+    out.push({ project, ...summarize(arr), byTool: toolBreakdown(arr) });
   }
   return out.sort((a, b) => b.tokensTotal - a.tokensTotal);
 }
@@ -53,11 +63,7 @@ export function perMonth(records) {
   const m = groupBy(records, r => r.month);
   const out = [];
   for (const [month, arr] of m) {
-    const byTool = {};
-    for (const r of arr) {
-      byTool[r.tool] = (byTool[r.tool] || 0) + r.tokensTotal;
-    }
-    out.push({ month, ...summarize(arr), byTool });
+    out.push({ month, ...summarize(arr), byTool: toolBreakdown(arr) });
   }
   return out.sort((a, b) => a.month.localeCompare(b.month));
 }
@@ -66,11 +72,7 @@ export function perWeek(records) {
   const m = groupBy(records, r => r.week);
   const out = [];
   for (const [week, arr] of m) {
-    const byTool = {};
-    for (const r of arr) {
-      byTool[r.tool] = (byTool[r.tool] || 0) + r.tokensTotal;
-    }
-    out.push({ week, ...summarize(arr), byTool });
+    out.push({ week, ...summarize(arr), byTool: toolBreakdown(arr) });
   }
   return out.sort((a, b) => a.week.localeCompare(b.week));
 }
@@ -84,6 +86,19 @@ export function perTool(records) {
   return out.sort((a, b) => b.tokensTotal - a.tokensTotal);
 }
 
+export function perToolPerMonth(records) {
+  // Cross-tab: one row per (tool, month). Lets you see how a single tool's
+  // usage is distributed across months — and avoids the hardcoded OC/CX/MM
+  // column problem in the per-month table.
+  const m = groupBy(records, r => `${r.tool}\u0001${r.month}`);
+  const out = [];
+  for (const [k, arr] of m) {
+    const [tool, month] = k.split('\u0001');
+    out.push({ tool, month, ...summarize(arr) });
+  }
+  return out.sort((a, b) => b.tokensTotal - a.tokensTotal);
+}
+
 export function overall(records) {
   return summarize(records);
 }

package/src/detectors.js

@@ -1,33 +1,14 @@
 // Auto-detect AI coding agent data directories.
 //
-// Strategy:
-//   1. Honor $AI_USAGE_PATHS_JSON if set (JSON map of { toolKey: "/abs/path" })
-//   2. Honor per-tool env var (e.g. $CLAUDE_HOME, $CODEX_HOME, $OPENCODE_HOME)
-//   3. Probe well-known locations per platform (mac/linux) relative to $HOME
-//   4. Return a status for each tool: 'present' | 'absent' | 'disabled'
-//
-// Tools that share the opencode SQLite schema are auto-registered.
-
-import { existsSync, statSync, readdirSync } from 'node:fs';
-import { join, isAbsolute } from 'node:path';
-import { homedir, platform } from 'node:os';
-import { env, exitCode } from 'node:process';
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
-
-const HOME = homedir();
-const OS = platform(); // 'darwin' | 'linux' | 'win32'
+// All tool configuration (paths, env vars, kinds, display metadata) lives
+// in src/tools.js. This file only orchestrates: probe paths, apply user
+// overrides, and project each tool's metadata into the detection result.
 
-// macOS Application Support helper
-const APP_SUPPORT = OS === 'darwin'
-  ? join(HOME, 'Library', 'Application Support')
-  : process.env.XDG_DATA_HOME
-    ? join(process.env.XDG_DATA_HOME, '..')  // XDG_DATA_HOME/../ = ~/.local/share
-    : join(HOME, '.local', 'share');
+import { existsSync } from 'node:fs';
+import { isAbsolute } from 'node:path';
+import { env } from 'node:process';
+import { TOOLS, TOOL_ORDER } from './tools.js';
 
-const CONFIG_HOME = process.env.XDG_CONFIG_HOME || join(HOME, '.config');
-
-// Probe = array of candidate paths; first one that exists wins.
 function firstExisting(paths) {
   for (const p of paths) {
     if (p && existsSync(p)) return p;
@@ -35,233 +16,17 @@ function firstExisting(paths) {
   return null;
 }
 
-function isFile(p) {
-  try { return statSync(p).isFile(); } catch { return false; }
-}
-function isDir(p) {
-  try { return statSync(p).isDirectory(); } catch { return false; }
+function safeParseJSON(s) {
+  try { return JSON.parse(s); } catch { return {}; }
 }
 
-// ---------------------------------------------------------------------------
-// Detector definitions. Each entry returns:
-//   { key, name, kind, status, path, count, details }
-// ---------------------------------------------------------------------------
-
-const DETECTORS = [
-  // -----------------------------------------------------------------------
-  // Claude Code
-  // -----------------------------------------------------------------------
-  {
-    key: 'claude',
-    name: 'Claude Code',
-    kind: 'jsonl',
-    envVar: 'CLAUDE_HOME',
-    candidatePaths: () => {
-      const base = env.CLAUDE_HOME || join(HOME, '.claude');
-      return [
-        join(base, 'transcripts'),
-        join(base, 'projects'),
-      ];
-    },
-    count: (p) => {
-      if (!p) return 0;
-      let n = 0;
-      try {
-        for (const f of readdirSync(p)) {
-          if (f.startsWith('ses_') && f.endsWith('.jsonl')) n++;
-        }
-      } catch {}
-      return n;
-    },
-    hasTokens: false,  // transcripts only contain text, no token counts
-    description: '~/.claude/transcripts/*.jsonl  (no token data stored locally)',
-  },
-
-  // -----------------------------------------------------------------------
-  // Codex
-  // -----------------------------------------------------------------------
-  {
-    key: 'codex',
-    name: 'Codex',
-    kind: 'jsonl-rollout',
-    envVar: 'CODEX_HOME',
-    candidatePaths: () => [
-      env.CODEX_HOME || join(HOME, '.codex', 'sessions'),
-    ],
-    count: (p) => {
-      if (!p) return 0;
-      let n = 0;
-      function walk(dir) {
-        try {
-          for (const e of readdirSync(dir, { withFileTypes: true })) {
-            const full = join(dir, e.name);
-            if (e.isDirectory()) walk(full);
-            else if (e.isFile() && e.name.startsWith('rollout-') && e.name.endsWith('.jsonl')) n++;
-          }
-        } catch {}
-      }
-      walk(p);
-      return n;
-    },
-    hasTokens: true,
-    description: '~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl',
-  },
-
-  // -----------------------------------------------------------------------
-  // OpenCode
-  // -----------------------------------------------------------------------
-  {
-    key: 'opencode',
-    name: 'OpenCode',
-    kind: 'sqlite',
-    envVar: 'OPENCODE_HOME',
-    candidatePaths: () => [
-      env.OPENCODE_HOME
-        ? join(env.OPENCODE_HOME, 'opencode.db')
-        : join(HOME, '.local', 'share', 'opencode', 'opencode.db'),
-    ],
-    count: (p) => {
-      if (!p) return 0;
-      try {
-        const { DatabaseSync } = require('node:sqlite');
-        const db = new DatabaseSync(p, { readOnly: true });
-        return db.prepare('SELECT COUNT(*) AS c FROM session').get().c;
-      } catch { return 0; }
-    },
-    hasTokens: true,
-    description: '~/.local/share/opencode/opencode.db  (tokens + cost)',
-  },
-
-  // -----------------------------------------------------------------------
-  // MimoCode (same schema as OpenCode)
-  // -----------------------------------------------------------------------
-  {
-    key: 'mimocode',
-    name: 'MimoCode',
-    kind: 'sqlite',
-    envVar: 'MIMOCODE_HOME',
-    candidatePaths: () => [
-      env.MIMOCODE_HOME
-        ? join(env.MIMOCODE_HOME, 'mimocode.db')
-        : join(HOME, '.local', 'share', 'mimocode', 'mimocode.db'),
-    ],
-    count: (p) => {
-      if (!p) return 0;
-      try {
-        const { DatabaseSync } = require('node:sqlite');
-        const db = new DatabaseSync(p, { readOnly: true });
-        return db.prepare('SELECT COUNT(*) AS c FROM session').get().c;
-      } catch { return 0; }
-    },
-    hasTokens: true,
-    description: '~/.local/share/mimocode/mimocode.db  (tokens + cost)',
-  },
-
-  // -----------------------------------------------------------------------
-  // GitHub Copilot CLI
-  // -----------------------------------------------------------------------
-  {
-    key: 'copilot',
-    name: 'GitHub Copilot',
-    kind: 'jsonl-events',
-    envVar: 'COPILOT_HOME',
-    candidatePaths: () => {
-      const base = env.COPILOT_HOME || join(HOME, '.copilot');
-      return [
-        join(base, 'session-state'),
-        base,
-      ];
-    },
-    count: (p) => {
-      if (!p) return 0;
-      let n = 0;
-      function walk(dir) {
-        try {
-          for (const e of readdirSync(dir, { withFileTypes: true })) {
-            const full = join(dir, e.name);
-            if (e.isDirectory()) walk(full);
-            else if (e.isFile() && e.name.endsWith('.jsonl')) n++;
-          }
-        } catch {}
-      }
-      walk(p);
-      return n;
-    },
-    hasTokens: false,
-    description: '~/.copilot/session-state/*/events.jsonl  (no token data)',
-  },
-
-  // -----------------------------------------------------------------------
-  // Antigravity (VS Code variant) - mostly cache; no token data
-  // -----------------------------------------------------------------------
-  {
-    key: 'antigravity',
-    name: 'Antigravity',
-    kind: 'dir',
-    envVar: 'ANTIGRAVITY_HOME',
-    candidatePaths: () => {
-      const base = env.ANTIGRAVITY_HOME || join(APP_SUPPORT, 'Antigravity');
-      return [
-        base,
-        join(HOME, '.antigravity'),
-      ];
-    },
-    count: (p) => {
-      if (!p) return 0;
-      let n = 0;
-      try {
-        for (const e of readdirSync(p)) {
-          const full = join(p, e);
-          if (statSync(full).isDirectory()) n++;
-        }
-      } catch {}
-      return n;
-    },
-    hasTokens: false,
-    description: '~/Library/Application Support/Antigravity  (no token data)',
-  },
-
-  // -----------------------------------------------------------------------
-  // Gemini CLI
-  // -----------------------------------------------------------------------
-  {
-    key: 'gemini',
-    name: 'Gemini CLI',
-    kind: 'protobuf',
-    envVar: 'GEMINI_HOME',
-    candidatePaths: () => {
-      const base = env.GEMINI_HOME || join(HOME, '.gemini');
-      return [
-        join(base, 'antigravity', 'conversations'),
-        join(base, 'conversations'),
-      ];
-    },
-    count: (p) => {
-      if (!p) return 0;
-      let n = 0;
-      try {
-        for (const f of readdirSync(p)) {
-          if (f.endsWith('.pb')) n++;
-        }
-      } catch {}
-      return n;
-    },
-    hasTokens: false,
-    description: '~/.gemini/antigravity/conversations/*.pb  (binary, no token data)',
-  },
-];
-
-// ---------------------------------------------------------------------------
-// Public: run all detectors
-// ---------------------------------------------------------------------------
-
 export function detectAll(opts = {}) {
   const override = opts.override || (env.AI_USAGE_PATHS_JSON
     ? safeParseJSON(env.AI_USAGE_PATHS_JSON)
     : {});
 
   const results = [];
-  for (const def of DETECTORS) {
+  for (const def of TOOLS) {
     let candidatePaths = def.candidatePaths();
 
     // Apply override if user supplied one
@@ -289,12 +54,4 @@ export function detectAll(opts = {}) {
   return results;
 }
 
-function safeParseJSON(s) {
-  try { return JSON.parse(s); } catch { return {}; }
-}
-
-// ---------------------------------------------------------------------------
-// Public: just keys in order (for stable UI columns)
-// ---------------------------------------------------------------------------
-
-export const TOOL_ORDER = DETECTORS.map(d => d.key);
+export { TOOL_ORDER };