agentlytics 0.0.6 → 0.0.8

package/README.md

@@ -6,12 +6,12 @@
 
 <p align="center">
   <strong>Unified analytics for your AI coding agents</strong><br>
-  <sub>Cursor · Windsurf · Claude Code · VS Code Copilot · Zed · Antigravity · OpenCode · Gemini CLI · Copilot CLI</sub>
+  <sub>Cursor · Windsurf · Claude Code · VS Code Copilot · Zed · Antigravity · OpenCode · Gemini CLI · Copilot CLI · Cursor Agent</sub>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/agentlytics"><img src="https://img.shields.io/npm/v/agentlytics?color=6366f1&label=npm" alt="npm"></a>
-  <a href="#supported-editors"><img src="https://img.shields.io/badge/editors-11-818cf8" alt="editors"></a>
+  <a href="#supported-editors"><img src="https://img.shields.io/badge/editors-12-818cf8" alt="editors"></a>
   <a href="#license"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%E2%89%A518-brightgreen" alt="node"></a>
 </p>
@@ -56,6 +56,7 @@ Opens at **http://localhost:4637**. Requires Node.js ≥ 18, macOS.
 | **OpenCode** | `opencode` | ✅ | ✅ | ✅ | ✅ |
 | **Gemini CLI** | `gemini-cli` | ✅ | ✅ | ✅ | ✅ |
 | **Copilot CLI** | `copilot-cli` | ✅ | ✅ | ✅ | ✅ |
+| **Cursor Agent** | `cursor-agent` | ✅ | ❌ | ❌ | ❌ |
 
 > Windsurf, Windsurf Next, and Antigravity must be running during scan.
 

package/editors/cursor-agent.js

@@ -0,0 +1,195 @@
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const CURSOR_PROJECTS_DIR = path.join(os.homedir(), '.cursor', 'projects');
+
+// ============================================================
+// Adapter interface
+// ============================================================
+
+const name = 'cursor-agent';
+
+/**
+ * Decode project directory name back to folder path.
+ * e.g. "Users-fka-Code-Wapple" → "/Users/fka/Code/Wapple"
+ */
+function decodeProjectDir(dirName) {
+  // The encoding replaces "/" with "-". We reconstruct by prepending "/"
+  // and replacing "-" back to "/". Handle ambiguity by checking if path exists.
+  const candidate = '/' + dirName.replace(/-/g, '/');
+  if (fs.existsSync(candidate)) return candidate;
+  // Fallback: try common patterns (the first segment is usually "Users")
+  const parts = dirName.split('-');
+  for (let i = 2; i < parts.length; i++) {
+    const prefix = '/' + parts.slice(0, i).join('/');
+    const suffix = parts.slice(i).join('-');
+    const full = path.join(prefix, suffix);
+    if (fs.existsSync(full)) return full;
+  }
+  return candidate;
+}
+
+/**
+ * Find all agent transcript JSONL files across all projects.
+ * Two patterns:
+ *   - <project>/agent-transcripts/<id>.jsonl (flat)
+ *   - <project>/agent-transcripts/<id>/<id>.jsonl (nested)
+ */
+function findTranscripts() {
+  const results = [];
+  if (!fs.existsSync(CURSOR_PROJECTS_DIR)) return results;
+
+  let projectDirs;
+  try { projectDirs = fs.readdirSync(CURSOR_PROJECTS_DIR); } catch { return results; }
+
+  for (const projDir of projectDirs) {
+    const transcriptsDir = path.join(CURSOR_PROJECTS_DIR, projDir, 'agent-transcripts');
+    if (!fs.existsSync(transcriptsDir)) continue;
+
+    let entries;
+    try { entries = fs.readdirSync(transcriptsDir); } catch { continue; }
+
+    const folder = decodeProjectDir(projDir);
+
+    for (const entry of entries) {
+      const entryPath = path.join(transcriptsDir, entry);
+
+      // Flat pattern: <id>.jsonl
+      if (entry.endsWith('.jsonl')) {
+        const sessionId = entry.replace('.jsonl', '');
+        results.push({ sessionId, jsonlPath: entryPath, folder });
+        continue;
+      }
+
+      // Nested pattern: <id>/<id>.jsonl
+      try {
+        if (fs.statSync(entryPath).isDirectory()) {
+          const nestedJsonl = path.join(entryPath, entry + '.jsonl');
+          if (fs.existsSync(nestedJsonl)) {
+            results.push({ sessionId: entry, jsonlPath: nestedJsonl, folder });
+          }
+        }
+      } catch { /* skip */ }
+    }
+  }
+  return results;
+}
+
+/**
+ * Parse a JSONL transcript file into an array of raw message objects.
+ * Each line: {"role":"user"|"assistant", "message":{"content":[{"type":"text","text":"..."}]}}
+ */
+function parseJsonl(jsonlPath) {
+  try {
+    const raw = fs.readFileSync(jsonlPath, 'utf-8');
+    return raw.split('\n').filter(Boolean).map(line => {
+      try { return JSON.parse(line); } catch { return null; }
+    }).filter(Boolean);
+  } catch { return []; }
+}
+
+/**
+ * Extract the first user query text from a parsed transcript (for chat name).
+ */
+function extractFirstUserText(entries) {
+  for (const e of entries) {
+    if (e.role !== 'user') continue;
+    const parts = e.message?.content;
+    if (!Array.isArray(parts)) continue;
+    for (const p of parts) {
+      if (p.type === 'text' && p.text) {
+        // Strip <user_query> wrapper if present
+        let text = p.text.replace(/<\/?user_query>/g, '').trim();
+        // Strip <attached_files> blocks
+        text = text.replace(/<attached_files>[\s\S]*?<\/attached_files>/g, '').trim();
+        if (text) return text.substring(0, 120);
+      }
+    }
+  }
+  return null;
+}
+
+function getChats() {
+  const chats = [];
+  const transcripts = findTranscripts();
+
+  for (const { sessionId, jsonlPath, folder } of transcripts) {
+    try {
+      const stat = fs.statSync(jsonlPath);
+      const entries = parseJsonl(jsonlPath);
+      if (entries.length === 0) continue;
+
+      // Count user/assistant messages
+      const userCount = entries.filter(e => e.role === 'user').length;
+      const assistantCount = entries.filter(e => e.role === 'assistant').length;
+      const bubbleCount = userCount + assistantCount;
+      if (bubbleCount === 0) continue;
+
+      chats.push({
+        source: 'cursor-agent',
+        composerId: sessionId,
+        name: extractFirstUserText(entries),
+        createdAt: stat.birthtimeMs || stat.mtimeMs,
+        lastUpdatedAt: stat.mtimeMs,
+        mode: 'agent',
+        folder,
+        bubbleCount,
+        _jsonlPath: jsonlPath,
+      });
+    } catch { /* skip */ }
+  }
+
+  return chats;
+}
+
+function getMessages(chat) {
+  const jsonlPath = chat._jsonlPath;
+  if (!jsonlPath || !fs.existsSync(jsonlPath)) return [];
+
+  const entries = parseJsonl(jsonlPath);
+  const result = [];
+
+  for (const entry of entries) {
+    const parts = entry.message?.content;
+    if (!Array.isArray(parts)) continue;
+
+    const textParts = [];
+    for (const p of parts) {
+      if (p.type === 'text' && p.text) {
+        let text = p.text;
+        // Clean up user_query wrappers
+        text = text.replace(/<\/?user_query>/g, '').trim();
+        // Clean attached_files blocks but note file references
+        const fileRefs = [];
+        text = text.replace(/<attached_files>([\s\S]*?)<\/attached_files>/g, (_, inner) => {
+          const paths = inner.match(/path="([^"]+)"/g);
+          if (paths) {
+            for (const pm of paths) {
+              const fp = pm.match(/path="([^"]+)"/);
+              if (fp) fileRefs.push(fp[1]);
+            }
+          }
+          return '';
+        }).trim();
+        // Clean image_files blocks
+        text = text.replace(/<image_files>[\s\S]*?<\/image_files>/g, '[image]').trim();
+        if (text) textParts.push(text);
+        if (fileRefs.length > 0) {
+          textParts.push(fileRefs.map(f => `[file: ${f}]`).join('\n'));
+        }
+      }
+    }
+
+    if (textParts.length > 0) {
+      result.push({
+        role: entry.role === 'user' ? 'user' : 'assistant',
+        content: textParts.join('\n'),
+      });
+    }
+  }
+
+  return result;
+}
+
+module.exports = { name, getChats, getMessages };

package/editors/index.js

@@ -6,8 +6,9 @@ const zed = require('./zed');
 const opencode = require('./opencode');
 const gemini = require('./gemini');
 const copilot = require('./copilot');
+const cursorAgent = require('./cursor-agent');
 
-const editors = [cursor, windsurf, claude, vscode, zed, opencode, gemini, copilot];
+const editors = [cursor, windsurf, claude, vscode, zed, opencode, gemini, copilot, cursorAgent];
 
 /**
  * Get all chats from all editor adapters, sorted by most recent first.

package/index.js

@@ -94,7 +94,7 @@ console.log(chalk.dim('  Initializing cache database...'));
 cache.initDb();
 
 // Scan all editors and populate cache
-console.log(chalk.dim('  Scanning editors: Cursor, Windsurf, Claude Code, VS Code, Zed, Antigravity, OpenCode, Gemini CLI, Copilot CLI'));
+console.log(chalk.dim('  Scanning editors: Cursor, Windsurf, Claude Code, VS Code, Zed, Antigravity, OpenCode, Gemini CLI, Copilot CLI, Cursor Agent'));
 const startTime = Date.now();
 const result = cache.scanAll((progress) => {
   process.stdout.write(chalk.dim(`\r  Scanning: ${progress.scanned}/${progress.total} chats (${progress.analyzed} analyzed, ${progress.skipped} cached)`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlytics",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Comprehensive analytics dashboard for AI coding agents — Cursor, Windsurf, Claude Code, VS Code Copilot, Zed, Antigravity, OpenCode",
   "main": "index.js",
   "bin": {

package/server.js

@@ -69,6 +69,51 @@ app.get('/api/chats/:id', (req, res) => {
   }
 });
 
+app.get('/api/chats/:id/markdown', (req, res) => {
+  try {
+    const result = cache.getCachedChat(req.params.id);
+    if (!result) return res.status(404).json({ error: 'Chat not found' });
+
+    const lines = [];
+    const title = result.name || 'Untitled Session';
+    lines.push(`# ${title}\n`);
+
+    // Metadata
+    const meta = [];
+    if (result.source) meta.push(`**Editor:** ${result.source}`);
+    if (result.mode) meta.push(`**Mode:** ${result.mode}`);
+    if (result.folder) meta.push(`**Project:** ${result.folder}`);
+    if (result.createdAt) meta.push(`**Created:** ${new Date(result.createdAt).toISOString()}`);
+    if (result.lastUpdatedAt) meta.push(`**Updated:** ${new Date(result.lastUpdatedAt).toISOString()}`);
+    if (result.stats) {
+      meta.push(`**Messages:** ${result.stats.totalMessages}`);
+      if (result.stats.totalInputTokens) meta.push(`**Input Tokens:** ${result.stats.totalInputTokens}`);
+      if (result.stats.totalOutputTokens) meta.push(`**Output Tokens:** ${result.stats.totalOutputTokens}`);
+      const models = [...new Set(result.stats.models || [])];
+      if (models.length > 0) meta.push(`**Models:** ${models.join(', ')}`);
+    }
+    if (meta.length > 0) lines.push(meta.join('  \n') + '\n');
+
+    lines.push('---\n');
+
+    // Messages
+    for (const msg of result.messages) {
+      const label = msg.role === 'user' ? '## User' : msg.role === 'assistant' ? '## Assistant' : `## ${msg.role.charAt(0).toUpperCase() + msg.role.slice(1)}`;
+      const modelTag = msg.model ? ` *(${msg.model})*` : '';
+      lines.push(`${label}${modelTag}\n`);
+      lines.push(msg.content + '\n');
+    }
+
+    const md = lines.join('\n');
+    const filename = title.replace(/[^a-zA-Z0-9_-]/g, '_').substring(0, 80) + '.md';
+    res.setHeader('Content-Type', 'text/markdown; charset=utf-8');
+    res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+    res.send(md);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
 app.get('/api/projects', (req, res) => {
   try {
     res.json(cache.getCachedProjects());

package/share-image.js

@@ -22,6 +22,7 @@ const EDITOR_COLORS = {
   'opencode': '#ec4899',
   'gemini-cli': '#4285f4',
   'copilot-cli': '#8957e5',
+  'cursor-agent': '#f59e0b',
 };
 
 const EDITOR_LABELS = {
@@ -37,6 +38,7 @@ const EDITOR_LABELS = {
   'opencode': 'OpenCode',
   'gemini-cli': 'Gemini CLI',
   'copilot-cli': 'Copilot CLI',
+  'cursor-agent': 'Cursor Agent',
 };
 
 function generateShareSvg(overview, stats) {

package/ui/src/lib/api.js

@@ -1,4 +1,4 @@
-const BASE = '';
+export const BASE = '';
 
 export async function fetchOverview(params = {}) {
   const q = new URLSearchParams();

package/ui/src/lib/constants.js

@@ -11,6 +11,7 @@ export const EDITOR_COLORS = {
   'opencode': '#ec4899',
   'gemini-cli': '#4285f4',
   'copilot-cli': '#8957e5',
+  'cursor-agent': '#f59e0b',
 };
 
 export const EDITOR_LABELS = {
@@ -26,6 +27,7 @@ export const EDITOR_LABELS = {
   'opencode': 'OpenCode',
   'gemini-cli': 'Gemini CLI',
   'copilot-cli': 'Copilot CLI',
+  'cursor-agent': 'Cursor Agent',
 };
 
 export function editorColor(src) {

package/ui/src/pages/ChatDetail.jsx

@@ -1,9 +1,9 @@
 import { useState, useEffect } from 'react'
 import { useParams, useNavigate } from 'react-router-dom'
-import { ArrowLeft, User, Bot, Wrench, Settings, Play, CheckCircle, ChevronRight, ChevronDown } from 'lucide-react'
+import { ArrowLeft, User, Bot, Wrench, Settings, Play, CheckCircle, ChevronRight, ChevronDown, Download } from 'lucide-react'
 import ReactMarkdown from 'react-markdown'
 import remarkGfm from 'remark-gfm'
-import { fetchChat } from '../lib/api'
+import { fetchChat, BASE } from '../lib/api'
 import { editorColor, editorLabel, formatDateTime, formatNumber } from '../lib/constants'
 import KpiCard from '../components/KpiCard'
 
@@ -184,7 +184,7 @@ export default function ChatDetail() {
       {/* Header */}
       <div className="card p-5 mb-4">
         <div className="flex items-start justify-between">
-          <div>
+          <div className="flex-1 min-w-0">
             <h2 className="text-xl font-semibold mb-1" style={{ color: 'var(--c-white)' }}>{chat.name || '(untitled)'}</h2>
             <div className="flex items-center gap-3 text-xs" style={{ color: 'var(--c-text2)' }}>
               <span className="inline-flex items-center gap-1.5">
@@ -200,6 +200,16 @@ export default function ChatDetail() {
               <span className="ml-3 font-mono" style={{ color: 'var(--c-text3)' }}>{chat.id}</span>
             </div>
           </div>
+          <a
+            href={`${BASE}/api/chats/${chat.id}/markdown`}
+            download
+            className="flex items-center gap-1.5 px-3 py-1.5 rounded text-xs font-medium transition shrink-0"
+            style={{ background: 'var(--c-bg3)', color: 'var(--c-text)', border: '1px solid var(--c-border)' }}
+            onMouseEnter={e => e.currentTarget.style.background = 'var(--c-bg2)'}
+            onMouseLeave={e => e.currentTarget.style.background = 'var(--c-bg3)'}
+          >
+            <Download size={13} /> Export .md
+          </a>
         </div>
       </div>