agentacta 1.3.2 → 1.3.4

package/README.md

@@ -14,6 +14,10 @@ One command. Zero config. Full visibility.
 npx agentacta
 ```
 
+<p align="center">
+  <img src="screenshots/demo.gif" alt="AgentActa demo" width="800">
+</p>
+
 ---
 
 ## Why
@@ -63,6 +67,7 @@ Open `http://localhost:4003` in your browser.
 AgentActa automatically finds your sessions in:
 - `~/.openclaw/agents/*/sessions/` (OpenClaw)
 - `~/.claude/projects/*/` (Claude Code)
+- `~/.codex/sessions/` (Codex CLI)
 
 Or point it at a custom path:
 
@@ -89,7 +94,7 @@ Download any session or search results as Markdown or JSON. Great for sharing, a
 
 ## How It Works
 
-AgentActa reads JSONL session files (the standard format used by OpenClaw and Claude Code), parses every message and tool call, and indexes them into a local SQLite database with FTS5 full-text search.
+AgentActa reads JSONL session files (including OpenClaw, Claude Code, and Codex CLI formats), parses every message and tool call, and indexes them into a local SQLite database with FTS5 full-text search.
 
 The web UI is a single-page app served by a lightweight Node.js HTTP server. No frameworks, no build step, no external dependencies beyond `better-sqlite3`.
 
@@ -197,7 +202,7 @@ All data stays local. AgentActa runs entirely on your machine — no cloud servi
 
 - ✅ [OpenClaw](https://github.com/openclaw/openclaw)
 - ✅ Claude Code
-- 🔜 Codex CLI
+- ✅ Codex CLI
 - 🔜 Custom JSONL formats
 
 ## Contributing

package/indexer.js

@@ -6,6 +6,25 @@ const { loadConfig } = require('./config');
 const REINDEX = process.argv.includes('--reindex');
 const WATCH = process.argv.includes('--watch');
 
+function listJsonlFiles(baseDir, recursive = false) {
+  if (!fs.existsSync(baseDir)) return [];
+  const out = [];
+
+  function walk(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (recursive) walk(full);
+        continue;
+      }
+      if (entry.isFile() && entry.name.endsWith('.jsonl')) out.push(full);
+    }
+  }
+
+  walk(baseDir);
+  return out;
+}
+
 function discoverSessionDirs(config) {
   const dirs = [];
   const home = process.env.HOME;
@@ -48,6 +67,12 @@ function discoverSessionDirs(config) {
     }
   }
 
+  // Scan ~/.codex/sessions recursively (Codex CLI stores nested YYYY/MM/DD/*.jsonl)
+  const codexSessions = path.join(home, '.codex/sessions');
+  if (fs.existsSync(codexSessions) && fs.statSync(codexSessions).isDirectory()) {
+    dirs.push({ path: codexSessions, agent: 'codex-cli', recursive: true });
+  }
+
   if (!dirs.length) {
     // Fallback to hardcoded
     const fallback = path.join(home, '.openclaw/agents/main/sessions');
@@ -63,6 +88,28 @@ function isHeartbeat(text) {
   return lower.includes('heartbeat') || lower.includes('heartbeat_ok');
 }
 
+function isBoilerplatePrompt(text) {
+  if (!text) return false;
+  const lower = text.toLowerCase();
+  return lower.includes('<permissions instructions>')
+    || lower.includes('filesystem sandboxing defines which files can be read or written')
+    || lower.includes('# agents.md instructions for ');
+}
+
+function isSummaryCandidate(text) {
+  if (!text || text.trim().length <= 10) return false;
+  if (isHeartbeat(text)) return false;
+  if (isBoilerplatePrompt(text)) return false;
+  return true;
+}
+
+function stripLeadingDatetimePrefix(text) {
+  if (!text) return text;
+  return text
+    .replace(/^\[(Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+\d{4}-\d{2}-\d{2}[^\]]*\]\s*/i, '')
+    .trim();
+}
+
 function extractContent(msg) {
   if (!msg || !msg.content) return '';
   if (typeof msg.content === 'string') return msg.content;
@@ -94,17 +141,60 @@ function extractToolResult(msg) {
   return null;
 }
 
+function extractCodexMessageText(content) {
+  if (!content) return '';
+  if (typeof content === 'string') return content;
+  if (!Array.isArray(content)) return '';
+
+  return content
+    .map((part) => {
+      if (!part || typeof part !== 'object') return '';
+      if (typeof part.text === 'string') return part.text;
+      if (typeof part.output_text === 'string') return part.output_text;
+      if (typeof part.input_text === 'string') return part.input_text;
+      return '';
+    })
+    .filter(Boolean)
+    .join('\n');
+}
+
 function extractFilePaths(toolName, toolArgs) {
   const paths = [];
   if (!toolArgs) return paths;
+
+  const maybePath = (value) => {
+    if (typeof value !== 'string') return;
+    if (value.startsWith('/') || value.startsWith('~/') || value.startsWith('./') || value.startsWith('../')) {
+      paths.push(value);
+      return;
+    }
+    if (value.includes('/') || value.includes('\\')) paths.push(value);
+  };
+
+  const visit = (obj) => {
+    if (!obj || typeof obj !== 'object') return;
+    if (Array.isArray(obj)) {
+      for (const item of obj) visit(item);
+      return;
+    }
+
+    for (const [key, value] of Object.entries(obj)) {
+      if (typeof value === 'string') {
+        if (['path', 'file_path', 'filePath', 'file', 'filename', 'cwd', 'workdir', 'directory', 'dir'].includes(key)) {
+          maybePath(value);
+        }
+      } else if (value && typeof value === 'object') {
+        visit(value);
+      }
+    }
+  };
+
   try {
     const args = typeof toolArgs === 'string' ? JSON.parse(toolArgs) : toolArgs;
-    // Common field names for file paths
-    for (const key of ['path', 'file_path', 'filePath', 'file', 'filename']) {
-      if (args[key] && typeof args[key] === 'string') paths.push(args[key]);
-    }
+    visit(args);
   } catch {}
-  return paths;
+
+  return [...new Set(paths)];
 }
 
 function aliasProject(project, config) {
@@ -177,9 +267,20 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
   let initialPrompt = null;
   let firstMessageId = null;
   let firstMessageTimestamp = null;
+  let codexProvider = null;
+  let codexSource = null;
+  let sawSnapshotRecord = false;
+  let sawNonSnapshotRecord = false;
+
+  let firstLine;
+  try {
+    firstLine = JSON.parse(lines[0]);
+  } catch {
+    return { skipped: true };
+  }
 
-  const firstLine = JSON.parse(lines[0]);
   let isClaudeCode = false;
+  let isCodexCli = false;
 
   if (firstLine.type === 'session') {
     // OpenClaw format
@@ -204,6 +305,20 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
       sessionId = path.basename(filePath, '.jsonl');
       sessionStart = new Date(firstLine.timestamp || Date.now()).toISOString();
     }
+  } else if (firstLine.type === 'session_meta') {
+    // Codex CLI format
+    isCodexCli = true;
+    const meta = firstLine.payload || {};
+    sessionId = meta.id || path.basename(filePath, '.jsonl');
+    sessionStart = meta.timestamp || firstLine.timestamp || new Date().toISOString();
+    sessionType = 'codex-cli';
+    agent = 'codex-cli';
+    if (meta.model) {
+      model = meta.model;
+      modelsSet.add(meta.model);
+    }
+    codexProvider = meta.model_provider || null;
+    codexSource = meta.source || null;
   } else {
     return { skipped: true };
   }
@@ -214,8 +329,9 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
   const projectCounts = new Map();
 
   // Seed project from session cwd when available (helps chat-only sessions)
-  if (firstLine && firstLine.cwd) {
-    const p = extractProjectFromPath(firstLine.cwd);
+  const sessionCwd = (firstLine && firstLine.cwd) || (firstLine && firstLine.payload && firstLine.payload.cwd);
+  if (sessionCwd) {
+    const p = extractProjectFromPath(sessionCwd, config);
     if (p) projectCounts.set(p, 1);
   }
 
@@ -223,6 +339,111 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
     let obj;
     try { obj = JSON.parse(line); } catch { continue; }
 
+    if (obj.type === 'file-history-snapshot') sawSnapshotRecord = true;
+    else sawNonSnapshotRecord = true;
+
+    if (isCodexCli) {
+      if (obj.type === 'session_meta') {
+        const meta = obj.payload || {};
+        if (meta.id) sessionId = meta.id;
+        if (meta.timestamp && !sessionStart) sessionStart = meta.timestamp;
+        if (meta.model) {
+          if (!model) model = meta.model;
+          modelsSet.add(meta.model);
+        }
+        if (meta.model_provider) codexProvider = meta.model_provider;
+        if (meta.source) codexSource = meta.source;
+        if (meta.model_provider && !model) model = meta.model_provider;
+        continue;
+      }
+
+      if (obj.type === 'turn_context' && obj.payload) {
+        const tc = obj.payload;
+        if (tc.model && typeof tc.model === 'string') {
+          if (!model || model === codexProvider) model = tc.model;
+          modelsSet.add(tc.model);
+        }
+        continue;
+      }
+
+      if (obj.type === 'response_item' && obj.payload) {
+        const p = obj.payload;
+        const ts = obj.timestamp || sessionStart;
+        const eventId = `evt-${obj.type}-${Date.parse(ts) || Math.random()}`;
+
+        if (p.type === 'function_call') {
+          const toolName = p.name || p.tool_name || '';
+          const toolArgs = typeof p.arguments === 'string' ? p.arguments : JSON.stringify(p.arguments || {});
+          const callBaseId = p.call_id || p.id || eventId;
+          pendingEvents.push([`${callBaseId}:call`, sessionId, ts, 'tool_call', 'assistant', null, toolName, toolArgs, null]);
+          toolCount++;
+
+          const fps = extractFilePaths(toolName, toolArgs);
+          for (const fp of fps) {
+            fileActivities.push([sessionId, fp, 'read', ts]);
+            const project = extractProjectFromPath(fp, config);
+            if (project) projectCounts.set(project, (projectCounts.get(project) || 0) + 1);
+          }
+          sessionEnd = ts;
+          continue;
+        }
+
+        if (p.type === 'function_call_output') {
+          const output = (typeof p.output === 'string' ? p.output : JSON.stringify(p.output || '')).slice(0, 10000);
+          const resultBaseId = p.call_id || p.id || eventId;
+          pendingEvents.push([`${resultBaseId}:result`, sessionId, ts, 'tool_result', 'tool', output, p.name || p.tool_name || '', null, output]);
+          sessionEnd = ts;
+          continue;
+        }
+
+        if (p.type === 'message') {
+          const rawRole = p.role || 'assistant';
+          const role = rawRole === 'assistant' ? 'assistant' : 'user';
+          const content = extractCodexMessageText(p.content);
+          if (content) {
+            pendingEvents.push([p.id || eventId, sessionId, ts, 'message', role, content, null, null, null]);
+            msgCount++;
+            if (!summary && role === 'user' && isSummaryCandidate(content)) summary = content.slice(0, 200);
+            if (!initialPrompt && role === 'user' && isSummaryCandidate(content)) {
+              initialPrompt = content.slice(0, 500);
+              firstMessageId = p.id || eventId;
+              firstMessageTimestamp = ts;
+            }
+          }
+          sessionEnd = ts;
+          continue;
+        }
+      }
+
+      if (obj.type === 'event_msg' && obj.payload) {
+        const p = obj.payload;
+        const ts = obj.timestamp || sessionStart;
+        const eventId = `evt-${p.type || 'event'}-${Date.parse(ts) || Math.random()}`;
+
+        if (p.type === 'agent_message' && p.message) {
+          pendingEvents.push([eventId, sessionId, ts, 'message', 'assistant', p.message, null, null, null]);
+          msgCount++;
+          sessionEnd = ts;
+          continue;
+        }
+
+        if (p.type === 'user_message' && p.message) {
+          pendingEvents.push([eventId, sessionId, ts, 'message', 'user', p.message, null, null, null]);
+          msgCount++;
+          if (!summary && isSummaryCandidate(p.message)) summary = p.message.slice(0, 200);
+          if (!initialPrompt && isSummaryCandidate(p.message)) {
+            initialPrompt = p.message.slice(0, 500);
+            firstMessageId = eventId;
+            firstMessageTimestamp = ts;
+          }
+          sessionEnd = ts;
+          continue;
+        }
+      }
+
+      continue;
+    }
+
     if (obj.type === 'session' || obj.type === 'model_change' || obj.type === 'thinking_level_change' || obj.type === 'custom' || obj.type === 'file-history-snapshot') {
       if (obj.type === 'model_change' && obj.modelId) {
         if (!model) model = obj.modelId; // First model for backwards compat
@@ -289,12 +510,12 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
       if (content) {
         pendingEvents.push([eventId, sessionId, ts, 'message', role, content, null, null, null]);
         msgCount++;
-        // Better summary: skip heartbeat messages
-        if (!summary && role === 'user' && !isHeartbeat(content)) {
+        // Better summary: skip heartbeat/boilerplate messages
+        if (!summary && role === 'user' && isSummaryCandidate(content)) {
           summary = content.slice(0, 200);
         }
         // Capture initial prompt from first substantial user message
-        if (!initialPrompt && role === 'user' && content.trim().length > 10 && !isHeartbeat(content)) {
+        if (!initialPrompt && role === 'user' && isSummaryCandidate(content)) {
           initialPrompt = content.slice(0, 500); // Limit to 500 chars
           firstMessageId = eventId;
           firstMessageTimestamp = ts;
@@ -321,9 +542,25 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
     }
   }
 
-  // If no real summary found, check if it's a heartbeat session
+  // Classify snapshot-only Claude files explicitly (avoid heartbeat mislabel)
+  if (isClaudeCode && sawSnapshotRecord && !sawNonSnapshotRecord) {
+    sessionType = 'snapshot';
+    if (!summary) summary = 'Claude file snapshot';
+  }
+
+  // Normalize summary text
+  if (summary) summary = stripLeadingDatetimePrefix(summary);
+
+  // If no real summary found, set a sensible default
   if (!summary) {
-    summary = 'Heartbeat session';
+    if (isCodexCli) {
+      const parts = ['Codex CLI session'];
+      if (codexProvider) parts.push(`provider=${codexProvider}`);
+      if (codexSource) parts.push(`source=${codexSource}`);
+      summary = parts.join(' · ');
+    } else {
+      summary = 'Heartbeat session';
+    }
   }
 
   // Infer session type from first user message content
@@ -389,9 +626,8 @@ function run() {
 
   let allFiles = [];
   for (const dir of sessionDirs) {
-    const files = fs.readdirSync(dir.path)
-      .filter(f => f.endsWith('.jsonl'))
-      .map(f => ({ path: path.join(dir.path, f), agent: dir.agent }));
+    const files = listJsonlFiles(dir.path, !!dir.recursive)
+      .map(filePath => ({ path: filePath, agent: dir.agent }));
     allFiles.push(...files);
   }
 
@@ -418,8 +654,33 @@ function run() {
 
   if (WATCH) {
     console.log('\nWatching for changes...');
+    const rescanTimers = new Map();
+
     for (const dir of sessionDirs) {
       fs.watch(dir.path, { persistent: true }, (eventType, filename) => {
+        // Recursive sources (e.g. ~/.codex/sessions/YYYY/MM/DD/*.jsonl):
+        // fs.watch on Linux does not watch nested dirs recursively, so on any root event
+        // run a debounced full rescan of known JSONL files under this source.
+        if (dir.recursive) {
+          const key = dir.path;
+          if (rescanTimers.get(key)) clearTimeout(rescanTimers.get(key));
+          const t = setTimeout(() => {
+            try {
+              const files = listJsonlFiles(dir.path, true);
+              let changed = 0;
+              for (const filePath of files) {
+                const result = indexFile(db, filePath, dir.agent, stmts, archiveMode, config);
+                if (!result.skipped) changed++;
+              }
+              if (changed > 0) console.log(`Re-indexed ${changed} files (${dir.agent})`);
+            } catch (err) {
+              console.error(`Error rescanning ${dir.path}:`, err.message);
+            }
+          }, 500);
+          rescanTimers.set(key, t);
+          return;
+        }
+
         if (!filename || !filename.endsWith('.jsonl')) return;
         const filePath = path.join(dir.path, filename);
         if (!fs.existsSync(filePath)) return;
@@ -444,13 +705,13 @@ function indexAll(db, config) {
   const stmts = createStmts(db);
   let totalSessions = 0;
   for (const dir of sessionDirs) {
-    const files = fs.readdirSync(dir.path).filter(f => f.endsWith('.jsonl'));
-    for (const file of files) {
+    const files = listJsonlFiles(dir.path, !!dir.recursive);
+    for (const filePath of files) {
       try {
-        const result = indexFile(db, path.join(dir.path, file), dir.agent, stmts, archiveMode, config);
+        const result = indexFile(db, filePath, dir.agent, stmts, archiveMode, config);
         if (!result.skipped) totalSessions++;
       } catch (err) {
-        console.error(`Error indexing ${file}:`, err.message);
+        console.error(`Error indexing ${path.basename(filePath)}:`, err.message);
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentacta",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Audit trail and search engine for AI agent sessions",
   "main": "index.js",
   "bin": {
@@ -42,13 +42,13 @@
   },
   "homepage": "https://github.com/mirajchokshi/agentacta",
   "dependencies": {
-    "better-sqlite3": "^11.0.0"
-  },
-  "devDependencies": {
-    "puppeteer-core": "^24.37.3",
-    "puppeteer-screen-recorder": "^3.0.6"
+    "better-sqlite3": "^12.6.2"
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "overrides": {
+    "tar-fs": "^3.0.6",
+    "npmlog": "^7.0.1"
   }
 }

package/public/app.js

@@ -226,12 +226,20 @@ function normalizeAgentLabel(a) {
   return a;
 }
 
+function isInternalProjectTag(tag) {
+  if (!tag) return true;
+  if (tag.startsWith('agent:')) return true;
+  if (tag.startsWith('claude:')) return true;
+  return false;
+}
+
 function renderProjectTags(s) {
   let projects = [];
   if (s.projects) {
     try { projects = JSON.parse(s.projects); } catch {}
   }
-  return projects.map(p => `<span class="session-project">${escHtml(p)}</span>`).join('');
+  const visible = [...new Set(projects)].filter(p => !isInternalProjectTag(p));
+  return visible.map(p => `<span class="session-project">${escHtml(p)}</span>`).join('');
 }
 
 function renderModelTags(s) {
@@ -246,6 +254,8 @@ function renderModelTags(s) {
 function renderSessionItem(s) {
   const duration = fmtDuration(s.start_time, s.end_time);
   const timeRange = `${fmtTime(s.start_time)} \u2192 ${s.end_time ? fmtTimeOnly(s.end_time) : 'now'}`;
+  const isSubagent = s.session_type === 'subagent';
+  const showAgentTag = s.agent && s.agent !== 'main' && !isSubagent;
 
   return `
     <div class="session-item" data-id="${s.id}">
@@ -253,8 +263,8 @@ function renderSessionItem(s) {
         <span class="session-time">${timeRange} \u00b7 ${duration}</span>
         <span style="display:flex;gap:6px;align-items:center;flex-wrap:wrap">
           ${renderProjectTags(s)}
-          ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(normalizeAgentLabel(s.agent))}</span>` : ''}
-          ${s.session_type ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
+          ${showAgentTag ? `<span class="session-agent">${escHtml(normalizeAgentLabel(s.agent))}</span>` : ''}
+          ${s.session_type && s.session_type !== normalizeAgentLabel(s.agent || '') ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
           ${renderModelTags(s)}
         </span>
       </div>
@@ -459,7 +469,7 @@ async function viewSession(id) {
         <span style="display:flex;gap:6px;align-items:center;flex-wrap:wrap">
           ${renderProjectTags(s)}
           ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(normalizeAgentLabel(s.agent))}</span>` : ''}
-          ${s.session_type ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
+          ${s.session_type && s.session_type !== normalizeAgentLabel(s.agent || '') ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
           ${renderModelTags(s)}
         </span>
       </div>

package/public/style.css

@@ -405,8 +405,8 @@ body {
 .session-project {
   font-size: 11px;
   font-weight: 500;
-  color: var(--green);
-  background: var(--green-soft);
+  color: #7fb4ff;
+  background: rgba(39, 94, 182, 0.18);
   padding: 2px 10px;
   border-radius: 10px;
 }