agentlytics 0.1.9 → 0.1.11

package/README.md

@@ -5,8 +5,8 @@
 <h1 align="center">Agentlytics</h1>
 
 <p align="center">
-  <strong>Unified analytics for your AI coding agents</strong><br>
-  <sub>Cursor · Windsurf · Claude Code · VS Code Copilot · Zed · Antigravity · OpenCode · Codex · Gemini CLI · Copilot CLI · Cursor Agent · Command Code</sub>
+  <strong>Your Cursor, Windsurf, Claude Code sessions — analyzed, unified, tracked.</strong><br>
+  <sub>One command to turn scattered AI conversations from <b>14 editors</b> into a unified analytics dashboard.<br>Sessions, costs, models, tools — finally in one place. 100% local.</sub>
 </p>
 
 <p align="center">
@@ -22,57 +22,84 @@
 
 ---
 
-Agentlytics reads local chat history from every major AI coding assistant and presents a unified analytics dashboard in your browser. **No data ever leaves your machine.**
+## The Problem
 
-## Quick Start
+You switch between Cursor, Windsurf, Claude Code, VS Code Copilot, and more — each with its own siloed conversation history.
+
+- ✗ Sessions scattered across editors, no unified view
+- ✗ No idea how much you're spending on AI tokens
+- ✗ Can't compare which editor is more effective
+- ✗ Can't search across all your AI conversations
+- ✗ No way to share session context with your team
+
+## The Solution
+
+**One command. Full picture. All local.**
 
 ```bash
 npx agentlytics
 ```
 
-Opens at **http://localhost:4637**. Requires Node.js ≥ 20.19 or ≥ 22.12, macOS.
+Opens at **http://localhost:4637**. Requires Node.js ≥ 20.19 or ≥ 22.12, macOS. No data ever leaves your machine.
+
+```
+$ npx agentlytics
+
+(● ●) [● ●] Agentlytics
+{● ●} <● ●> Unified analytics for your AI coding agents
+
+Looking for AI coding agents...
+   ✓ Cursor              498 sessions
+   ✓ Windsurf             20 sessions
+   ✓ Windsurf Next        56 sessions
+   ✓ Claude Code           6 sessions
+   ✓ VS Code              23 sessions
+   ✓ Zed                   1 session
+   ✓ Codex                 3 sessions
+   ✓ Gemini CLI            2 sessions
+   ...and 6 more
+
+(● ●) [● ●] {● ●} <● ●> ✓ 691 analyzed, 360 cached (27.1s)
+✓ Dashboard ready at http://localhost:4637
+```
 
-To only build the cache database without starting the server:
+To only build the cache without starting the server:
 
 ```bash
 npx agentlytics --collect
 ```
 
-For local development, run `npm run dev` from the repo root. That starts both the backend on `http://localhost:4637` and the Vite frontend on `http://localhost:5173`.
-
 ## Features
 
 - **Dashboard** — KPIs, activity heatmap, editor breakdown, coding streaks, token economy, peak hours, top models & tools
-- **Sessions** — Search, filter, full conversation viewer with syntax highlighting and diff views
-- **Projects** — Per-project analytics: sessions, messages, tokens, models, editor breakdown
-- **Deep Analysis** — Tool frequency, model distribution, token breakdown with drill-down
-- **Compare** — Side-by-side editor comparison with efficiency ratios
-- **Refetch** — One-click cache rebuild with live progress
-- **Relay** — Multi-user context sharing with MCP server for cross-team AI session querying
+- **Sessions** — Search, filter, and read full conversations with syntax highlighting. Open any chat in a slide-over sidebar.
+- **Costs** — Estimate your AI spend broken down by model, editor, project, and month. Spot your most expensive sessions.
+- **Projects** — Per-project analytics: sessions, messages, tokens, models, editor breakdown, and drill-down detail views
+- **Deep Analysis** — Tool frequency heatmaps, model distribution, token breakdown, and filterable drill-down analytics
+- **Compare** — Side-by-side editor comparison with efficiency ratios, token usage, and session patterns
+- **Relay** — Share AI session context across your team via MCP
 
 ## Supported Editors
 
-| Editor | ID | Msgs | Tools | Models | Tokens |
-|--------|----|:----:|:-----:|:------:|:------:|
-| **Cursor** | `cursor` | ✅ | ✅ | ⚠️ | ⚠️ |
-| **Windsurf** | `windsurf` | ✅ | ✅ | ✅ | ✅ |
-| **Windsurf Next** | `windsurf-next` | ✅ | ✅ | ✅ | ✅ |
-| **Antigravity** | `antigravity` | ✅ | ✅ | ✅ | ✅ |
-| **Claude Code** | `claude-code` | ✅ | ✅ | ✅ | ✅ |
-| **VS Code** | `vscode` | ✅ | ✅ | ✅ | ✅ |
-| **VS Code Insiders** | `vscode-insiders` | ✅ | ✅ | ✅ | ✅ |
-| **Zed** | `zed` | ✅ | ✅ | ✅ | ❌ |
-| **OpenCode** | `opencode` | ✅ | ✅ | ✅ | ✅ |
-| **Codex** | `codex` | ✅ | ✅ | ✅ | ✅ |
-| **Gemini CLI** | `gemini-cli` | ✅ | ✅ | ✅ | ✅ |
-| **Copilot CLI** | `copilot-cli` | ✅ | ✅ | ✅ | ✅ |
-| **Cursor Agent** | `cursor-agent` | ✅ | ❌ | ❌ | ❌ |
-| **Command Code** | `commandcode` | ✅ | ✅ | ❌ | ❌ |
+| Editor | Msgs | Tools | Models | Tokens |
+|--------|:----:|:-----:|:------:|:------:|
+| **Cursor** | ✅ | ✅ | ⚠️ | ⚠️ |
+| **Windsurf** | ✅ | ✅ | ✅ | ✅ |
+| **Windsurf Next** | ✅ | ✅ | ✅ | ✅ |
+| **Antigravity** | ✅ | ✅ | ✅ | ✅ |
+| **Claude Code** | ✅ | ✅ | ✅ | ✅ |
+| **VS Code** | ✅ | ✅ | ✅ | ✅ |
+| **VS Code Insiders** | ✅ | ✅ | ✅ | ✅ |
+| **Zed** | ✅ | ✅ | ✅ | ❌ |
+| **OpenCode** | ✅ | ✅ | ✅ | ✅ |
+| **Codex** | ✅ | ✅ | ✅ | ✅ |
+| **Gemini CLI** | ✅ | ✅ | ✅ | ✅ |
+| **Copilot CLI** | ✅ | ✅ | ✅ | ✅ |
+| **Cursor Agent** | ✅ | ❌ | ❌ | ❌ |
+| **Command Code** | ✅ | ✅ | ❌ | ❌ |
 
 > Windsurf, Windsurf Next, and Antigravity must be running during scan.
 
-Codex sessions are read from `${CODEX_HOME:-~/.codex}/sessions/**/*.jsonl`. Reasoning summaries may appear in transcripts when Codex records them in clear text, but encrypted reasoning content is not readable. Codex Desktop and CLI sessions are aggregated into one `codex` editor in analytics.
-
 ## Relay
 
 Relay enables multi-user context sharing across a team. One person starts a relay server, others join and share selected project sessions. An MCP server is exposed so AI clients can query across everyone's coding history.

package/cache.js

@@ -2,13 +2,56 @@ const Database = require('better-sqlite3');
 const path = require('path');
 const os = require('os');
 const fs = require('fs');
-const { getAllChats, getMessages, findChat: findChatRaw, resetCaches } = require('./editors');
+const { getAllChats, getMessages, resetCaches } = require('./editors');
 const { calculateCost, getModelPricing, normalizeModelName } = require('./pricing');
 
 const CACHE_DIR = path.join(os.homedir(), '.agentlytics');
 const CACHE_DB = path.join(CACHE_DIR, 'cache.db');
 const SCHEMA_VERSION = 5; // bump this when schema changes to auto-revalidate
 
+/**
+ * Normalize a folder path for consistent storage/lookup.
+ * - Strips file:// prefix
+ * - On Windows: resolves real disk casing via fs.realpathSync.native(),
+ *   falls back to uppercase drive letter + lowercase rest, trims trailing backslash,
+ *   and converts backslashes to forward slashes.
+ * - On macOS/Linux: resolves symlinks via fs.realpathSync().
+ */
+function normalizeFolder(folder) {
+  if (!folder) return folder;
+  // Strip file:// prefix
+  folder = folder.replace(/^file:\/\//, '');
+
+  if (process.platform === 'win32') {
+    try {
+      folder = path.resolve(folder);
+      try {
+        folder = fs.realpathSync.native(folder);
+      } catch {
+        // realpathSync.native failed — uppercase drive letter, lowercase rest
+        if (/^[a-zA-Z]:/.test(folder)) {
+          folder = folder[0].toUpperCase() + folder.slice(1);
+        }
+      }
+      // Remove trailing backslash (but keep "C:\")
+      folder = folder.replace(/\\$/, '');
+      if (/^[A-Z]:$/.test(folder)) folder += '\\';
+      // Convert backslashes to forward slashes
+      folder = folder.replace(/\\/g, '/');
+    } catch {
+      // If all else fails, just return as-is with forward slashes
+      folder = folder.replace(/\\/g, '/');
+    }
+  } else {
+    try {
+      folder = fs.realpathSync(folder);
+    } catch {
+      // Path doesn't exist, return as-is
+    }
+  }
+  return folder;
+}
+
 let db = null;
 
 // ============================================================
@@ -113,6 +156,30 @@ function initDb() {
 
   // Store schema version so future runs can detect mismatches
   db.prepare('INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)').run('schema_version', SCHEMA_VERSION.toString());
+
+  // v2 migration: normalize folder paths on Windows
+  if (process.platform === 'win32') {
+    let normV = 0;
+    try {
+      const row = db.prepare("SELECT value FROM meta WHERE key = 'folder_norm_v'").get();
+      if (row) normV = parseInt(row.value) || 0;
+    } catch {}
+    if (normV < 2) {
+      const chatRows = db.prepare('SELECT id, folder FROM chats WHERE folder IS NOT NULL').all();
+      const updChat = db.prepare('UPDATE chats SET folder = ? WHERE id = ?');
+      for (const r of chatRows) {
+        const norm = normalizeFolder(r.folder);
+        if (norm !== r.folder) updChat.run(norm, r.id);
+      }
+      const tcRows = db.prepare('SELECT id, folder FROM tool_calls WHERE folder IS NOT NULL').all();
+      const updTc = db.prepare('UPDATE tool_calls SET folder = ? WHERE id = ?');
+      for (const r of tcRows) {
+        const norm = normalizeFolder(r.folder);
+        if (norm !== r.folder) updTc.run(norm, r.id);
+      }
+      db.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES ('folder_norm_v', '2')").run();
+    }
+  }
 }
 
 // ============================================================
@@ -245,6 +312,9 @@ function scanAll(onProgress, opts = {}) {
     }
   });
 
+  // Normalize folder paths
+  for (const chat of chats) chat.folder = normalizeFolder(chat.folder);
+
   // Insert all chats in a transaction
   batchInsert(chats);
 
@@ -401,7 +471,7 @@ function getCachedOverview(opts = {}) {
     GROUP BY folder ORDER BY count DESC LIMIT 20
   `).all(...params);
   const topProjects = projects.map(p => ({
-    name: p.folder.split('/').slice(-2).join('/'),
+    name: p.folder.split(/[/\\]/).slice(-2).join('/'),
     fullPath: p.folder,
     count: p.count,
   }));
@@ -644,7 +714,7 @@ function getCachedProjects(opts = {}) {
 
     result.push({
       folder: proj.folder,
-      name: proj.folder.split('/').pop(),
+      name: proj.folder.split(/[/\\]/).pop(),
       totalSessions: proj.totalSessions,
       editors: proj.editors,
       firstSeen: proj.firstSeen,
@@ -694,16 +764,6 @@ function safeParseJson(s) {
   try { return JSON.parse(s); } catch { return {}; }
 }
 
-function resetAndRescan(onProgress) {
-  if (db) db.close();
-  if (fs.existsSync(CACHE_DB)) fs.unlinkSync(CACHE_DB);
-  for (const suffix of ['-wal', '-shm']) {
-    if (fs.existsSync(CACHE_DB + suffix)) fs.unlinkSync(CACHE_DB + suffix);
-  }
-  initDb();
-  return scanAll(onProgress);
-}
-
 /**
  * Async version of scanAll that yields the event loop between iterations.
  * Required for SSE streaming so progress events actually flush to the client.
@@ -720,6 +780,9 @@ async function scanAllAsync(onProgress) {
     existing[row.id] = row.last_updated_at;
   }
 
+  // Normalize folder paths
+  for (const chat of chats) chat.folder = normalizeFolder(chat.folder);
+
   const ins = insertChat();
   const batchInsert = db.transaction((chatBatch) => {
     for (const chat of chatBatch) {
@@ -1316,7 +1379,6 @@ module.exports = {
   getCachedChat,
   getCachedProjects,
   getCachedToolCalls,
-  resetAndRescan,
   resetAndRescanAsync,
   getCachedDashboardStats,
   getCostBreakdown,

package/editors/base.js

@@ -1,6 +1,5 @@
 const path = require('path');
 const os = require('os');
-const chalk = require('chalk');
 
 const HOME = os.homedir();
 
@@ -23,112 +22,6 @@ function getAppDataPath(appName) {
   }
 }
 
-// --- Formatting utilities shared across all editor adapters ---
-
-function formatArgs(args, maxLen = 300) {
-  if (!args || typeof args !== 'object') return '';
-  const lines = [];
-  for (const [key, val] of Object.entries(args)) {
-    let display = typeof val === 'string' ? val : JSON.stringify(val);
-    if (display && display.length > maxLen) {
-      display = display.substring(0, maxLen) + chalk.dim(`… (${display.length} chars)`);
-    }
-    lines.push(`    ${chalk.dim(key + ':')} ${display}`);
-  }
-  return lines.join('\n');
-}
-
-function formatToolCall(item) {
-  const name = item.toolName || 'unknown';
-  const id = item.toolCallId || '';
-  const decision = item.userDecision;
-  const decisionStr = decision === 'accepted' ? chalk.green(' ✓accepted')
-    : decision === 'rejected' ? chalk.red(' ✗rejected')
-    : decision ? chalk.yellow(` ${decision}`) : '';
-  let out = `  ${chalk.magenta('▶')} ${chalk.bold.magenta(name)}${decisionStr} ${chalk.dim(id)}`;
-  if (item.args && Object.keys(item.args).length > 0) {
-    out += '\n' + formatArgs(item.args);
-  }
-  return out;
-}
-
-function formatToolResult(item) {
-  const name = item.toolName || 'unknown';
-  const result = typeof item.result === 'string' ? item.result : JSON.stringify(item.result || '');
-  const maxPreview = 500;
-  const preview = result.length > maxPreview
-    ? result.substring(0, maxPreview) + chalk.dim(`… (${result.length} chars)`)
-    : result;
-  const status = result.startsWith('Rejected') ? chalk.red('✗ rejected') : chalk.green('✓ ok');
-  let out = `  ${chalk.yellow('◀')} ${chalk.bold.yellow(name)} ${status}`;
-  if (preview.trim()) {
-    out += '\n    ' + chalk.dim(preview.replace(/\n/g, '\n    '));
-  }
-  return out;
-}
-
-function extractText(content, { richToolDisplay = false } = {}) {
-  if (typeof content === 'string') return content;
-  if (!Array.isArray(content)) return '';
-  return content
-    .map((item) => {
-      if (item.type === 'text') return item.text;
-      if (item.type === 'reasoning') return `[thinking] ${item.text}`;
-      if (item.type === 'tool-call') {
-        return richToolDisplay
-          ? formatToolCall(item)
-          : `[tool-call: ${item.toolName || 'unknown'}(${Object.keys(item.args || {}).join(', ')})]`;
-      }
-      if (item.type === 'tool-result') {
-        return richToolDisplay
-          ? formatToolResult(item)
-          : `[tool-result: ${item.toolName || 'unknown'}] ${(typeof item.result === 'string' ? item.result : '').substring(0, 200)}`;
-      }
-      return '';
-    })
-    .filter(Boolean)
-    .join('\n');
-}
-
-function roleColor(role) {
-  switch (role) {
-    case 'user': return chalk.green;
-    case 'assistant': return chalk.cyan;
-    case 'system': return chalk.gray;
-    case 'tool': return chalk.yellow;
-    default: return chalk.white;
-  }
-}
-
-function roleLabel(role) {
-  switch (role) {
-    case 'user': return '👤 User';
-    case 'assistant': return '🤖 Assistant';
-    case 'system': return '⚙️  System';
-    case 'tool': return '🔧 Tool';
-    default: return role;
-  }
-}
-
-function formatDate(ts) {
-  if (!ts) return 'unknown';
-  return new Date(ts).toLocaleString();
-}
-
-function truncate(str, max = 120) {
-  if (!str) return '';
-  const oneLine = str.replace(/\n/g, ' ').trim();
-  return oneLine.length > max ? oneLine.substring(0, max) + '…' : oneLine;
-}
-
-function shortenPath(p, maxLen = 40) {
-  if (!p) return '';
-  if (p.length <= maxLen) return p;
-  const parts = p.split('/');
-  if (parts.length <= 3) return p;
-  return '…/' + parts.slice(-2).join('/');
-}
-
 /**
  * Every editor adapter must implement:
  *
@@ -141,13 +34,4 @@ function shortenPath(p, maxLen = 40) {
 
 module.exports = {
   getAppDataPath,
-  formatArgs,
-  formatToolCall,
-  formatToolResult,
-  extractText,
-  roleColor,
-  roleLabel,
-  formatDate,
-  truncate,
-  shortenPath,
 };

package/editors/codex.js

@@ -439,15 +439,4 @@ module.exports = {
   name,
   getChats,
   getMessages,
-  _test: {
-    getSessionsDir,
-    readChatMetadata,
-    parseSessionMessages,
-    normalizeRawUsage,
-    subtractRawUsage,
-    convertToDelta,
-    extractModel,
-    isBootstrapMessage,
-    previewToolOutput,
-  },
 };

package/editors/index.js

@@ -46,18 +46,10 @@ function getMessages(chat) {
   return resolvedEditor.getMessages(chat);
 }
 
-/**
- * Find a chat by ID prefix across all editors.
- */
-function findChat(idPrefix) {
-  const chats = getAllChats();
-  return chats.find((c) => c.composerId.startsWith(idPrefix));
-}
-
 function resetCaches() {
   for (const editor of editors) {
     if (typeof editor.resetCache === 'function') editor.resetCache();
   }
 }
 
-module.exports = { getAllChats, getMessages, findChat, editors, resetCaches };
+module.exports = { getAllChats, getMessages, editors, resetCaches };

package/editors/opencode.js

@@ -14,7 +14,7 @@ function queryDb(sql) {
   try {
     const raw = execSync(
       `sqlite3 -json ${JSON.stringify(DB_PATH)} ${JSON.stringify(sql)}`,
-      { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 }
+      { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
     );
     return JSON.parse(raw);
   } catch { return []; }

package/editors/windsurf.js

@@ -23,7 +23,7 @@ function findLanguageServers() {
   if (_lsCache) return _lsCache;
   _lsCache = [];
   try {
-    const ps = execSync('ps aux', { encoding: 'utf-8', maxBuffer: 1024 * 1024 });
+    const ps = execSync('ps aux', { encoding: 'utf-8', maxBuffer: 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] });
     for (const line of ps.split('\n')) {
       if (!line.includes('language_server_macos') || !line.includes('--csrf_token')) continue;
       const csrfMatch = line.match(/--csrf_token\s+(\S+)/);
@@ -38,7 +38,7 @@ function findLanguageServers() {
       if (!pidMatch) continue;
       const pid = pidMatch[1];
       try {
-        const lsof = execSync(`lsof -i TCP -P -n -a -p ${pid} 2>/dev/null`, { encoding: 'utf-8' });
+        const lsof = execSync(`lsof -i TCP -P -n -a -p ${pid} 2>/dev/null`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
         for (const l of lsof.split('\n')) {
           const portMatch = l.match(/TCP\s+127\.0\.0\.1:(\d+)\s+\(LISTEN\)/);
           if (portMatch) {
@@ -79,7 +79,7 @@ function callRpc(port, csrf, method, body, useHttps) {
       `-H "x-codeium-csrf-token: ${csrf}" ` +
       `-d ${JSON.stringify(data)} ` +
       `--max-time 10`,
-      { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 }
+      { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
     );
     return JSON.parse(result);
   } catch { return null; }

package/editors/zed.js

@@ -15,7 +15,7 @@ function decompressZstd(buf) {
   const tmpOut = tmpIn.replace('.zst', '.json');
   try {
     fs.writeFileSync(tmpIn, buf);
-    execSync(`zstd -d -f -q ${JSON.stringify(tmpIn)} -o ${JSON.stringify(tmpOut)}`, { stdio: 'pipe' });
+    execSync(`zstd -d -f -q ${JSON.stringify(tmpIn)} -o ${JSON.stringify(tmpOut)}`, { stdio: ['pipe', 'pipe', 'pipe'] });
     const data = fs.readFileSync(tmpOut, 'utf-8');
     return data;
   } finally {
@@ -33,7 +33,7 @@ function queryDb(sql) {
   try {
     const raw = execSync(
       `sqlite3 -json ${JSON.stringify(THREADS_DB)} ${JSON.stringify(sql)}`,
-      { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 }
+      { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
     );
     return JSON.parse(raw);
   } catch { return []; }
@@ -44,7 +44,7 @@ function queryBlobHex(id) {
   try {
     const hex = execSync(
       `sqlite3 ${JSON.stringify(THREADS_DB)} "SELECT hex(data) FROM threads WHERE id = '${id}'"`,
-      { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 }
+      { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024, stdio: ['pipe', 'pipe', 'pipe'] }
     ).trim();
     if (!hex) return null;
     return Buffer.from(hex, 'hex');

package/index.js

@@ -174,7 +174,8 @@ if (noCache) {
   }
 }
 
-// ── Warn about installed-but-not-running Windsurf variants ─
+// ── Warn about installed-but-not-running Windsurf variants (macOS only) ─
+if (process.platform === 'darwin') {
 const WINDSURF_VARIANTS = [
   { name: 'Windsurf', app: '/Applications/Windsurf.app', dataDir: path.join(HOME, '.codeium', 'windsurf'), ide: 'windsurf' },
   { name: 'Windsurf Next', app: '/Applications/Windsurf Next.app', dataDir: path.join(HOME, '.codeium', 'windsurf-next'), ide: 'windsurf-next' },
@@ -208,6 +209,7 @@ const WINDSURF_VARIANTS = [
     console.log('');
   }
 })();
+}
 
 // Initialize cache DB
 cache.initDb();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlytics",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Comprehensive analytics dashboard for AI coding agents — Cursor, Windsurf, Claude Code, VS Code Copilot, Zed, Antigravity, OpenCode, Command Code",
   "main": "index.js",
   "bin": {
@@ -54,9 +54,7 @@
     "@modelcontextprotocol/sdk": "^1.27.1",
     "better-sqlite3": "^12.6.2",
     "chalk": "^4.1.2",
-    "commander": "^14.0.3",
     "express": "^4.22.1",
-    "inquirer": "^13.3.0",
     "log-update": "^4.0.0",
     "open": "^8.4.2"
   }