agentacta 2026.3.5 → 2026.3.7

package/README.md

@@ -39,20 +39,10 @@ AgentActa gives you one place to inspect the full trail.
 - ⚡ Live indexing via file watching
 - 📱 Mobile-friendly UI
 - 💡 Search suggestions based on real data
+- ⌨️ Command palette (⌘K / Ctrl+K) for quick navigation
+- 🎨 Theme settings (system, light, dark, OLED)
+- 🏥 Health endpoint for monitoring (`/api/health`)
 
-## Demo
-
-https://github.com/mirajchokshi/agentacta/raw/main/screenshots/demo-final.mp4
-
-## Screenshots
-
-![Search](screenshots/search.png)
-![Sessions](screenshots/sessions.png)
-![Session Detail](screenshots/session-detail.png)
-![Timeline](screenshots/timeline.png)
-![Files](screenshots/files.png)
-![Stats](screenshots/stats.png)
-![Search Results](screenshots/search-results.png)
 
 ## Quick start
 
@@ -128,18 +118,20 @@ On first run, AgentActa creates:
 - `~/.config/agentacta/config.json`
 - or `agentacta.config.json` in current directory (if present)
 
-Default config:
+Default config (auto-generated on first run — session directories are detected automatically):
 
 ```json
 {
   "port": 4003,
   "storage": "reference",
-  "sessionsPath": null,
+  "sessionsPath": ["~/.claude/projects", "~/.openclaw/sessions"],
   "dbPath": "./agentacta.db",
   "projectAliases": {}
 }
 ```
 
+`sessionsPath` accepts a string, a colon-delimited string, or a JSON array.
+
 ### Storage modes
 
 - `reference` (default): index parsed events in SQLite, keep source JSONL on disk. Lightweight.
@@ -170,6 +162,7 @@ Default config:
 | `GET /api/export/session/:id?format=md` | Export one session |
 | `GET /api/timeline/stream?after=<ts>` | SSE stream for live timeline updates |
 | `POST /api/maintenance` | VACUUM + WAL checkpoint (returns size before/after) |
+| `GET /api/health` | Server status, version, uptime, session count |
 | `GET /api/export/search?q=<query>&format=md` | Export search results |
 
 Agent integration example:
@@ -179,19 +172,6 @@ const res = await fetch('http://localhost:4003/api/search?q=deployment+issue&lim
 const data = await res.json();
 ```
 
-## Demo mode
-
-```bash
-# seed demo data + run
-npm run demo
-
-# or split steps
-node scripts/seed-demo.js
-node index.js --demo
-```
-
-Demo mode creates 7 realistic sessions (weather app build path: scaffolding, API, frontend, debugging, deployment, tests, sub-agent task).
-
 ## Security
 
 AgentActa binds to `127.0.0.1` by default.

package/config.js

@@ -14,6 +14,12 @@ function resolveConfigFile() {
 
 const CONFIG_FILE = resolveConfigFile();
 
+const KNOWN_SESSION_DIRS = [
+  path.join(os.homedir(), '.claude', 'projects'),    // Claude Code
+  path.join(os.homedir(), '.codex', 'sessions'),     // Codex CLI
+  path.join(os.homedir(), '.openclaw', 'sessions'),  // OpenClaw
+];
+
 const DEFAULTS = {
   port: 4003,
   storage: 'reference',
@@ -22,6 +28,11 @@ const DEFAULTS = {
   projectAliases: {}
 };
 
+function detectSessionDirs() {
+  const found = KNOWN_SESSION_DIRS.filter(d => fs.existsSync(d));
+  return found.length > 0 ? found : null;
+}
+
 function loadConfig() {
   let fileConfig = {};
 
@@ -32,11 +43,18 @@ function loadConfig() {
       console.error(`Warning: Could not parse ${CONFIG_FILE}:`, err.message);
     }
   } else {
-    // First-run: create default config in XDG location
+    // First-run: create default config with auto-detected session dirs
+    const detected = detectSessionDirs();
+    const firstRunDefaults = { ...DEFAULTS, sessionsPath: detected };
     const dir = path.dirname(CONFIG_FILE);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(DEFAULTS, null, 2) + '\n');
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(firstRunDefaults, null, 2) + '\n');
+    // Apply to in-memory config so this run also benefits
+    fileConfig = firstRunDefaults;
     console.log(`Created default config: ${CONFIG_FILE}`);
+    if (detected) {
+      console.log(`Auto-detected session directories:\n${detected.map(d => `  - ${d}`).join('\n')}`);
+    }
   }
 
   const config = { ...DEFAULTS, ...fileConfig };

package/index.js

@@ -4,6 +4,13 @@ const fs = require('fs');
 const path = require('path');
 const { EventEmitter } = require('events');
 
+// --version / -v flag: print version and exit
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  const pkg = require('./package.json');
+  console.log(`${pkg.name} v${pkg.version}`);
+  process.exit(0);
+}
+
 // --demo flag: use demo session data (must run before config load)
 if (process.argv.includes('--demo')) {
   const demoDir = path.join(__dirname, 'demo');
@@ -193,6 +200,20 @@ const server = http.createServer((req, res) => {
       return json(res, { ok: true, sessions: result.sessions, events: result.events });
     }
 
+    else if (pathname === '/api/health') {
+      const pkg = require('./package.json');
+      const sessions = db.prepare('SELECT COUNT(*) as c FROM sessions').get().c;
+      const dbSize = getDbSize();
+      return json(res, {
+        status: 'ok',
+        version: pkg.version,
+        uptime: Math.round(process.uptime()),
+        sessions,
+        dbSizeBytes: dbSize.bytes,
+        node: process.version
+      });
+    }
+
     else if (pathname === '/api/config') {
       const dbSize = getDbSize();
       const archiveCount = db.prepare('SELECT COUNT(*) as c FROM archive').get().c;

package/indexer.js

@@ -29,16 +29,36 @@ function discoverSessionDirs(config) {
   const dirs = [];
   const home = process.env.HOME;
 
+  // Expand a single path into session dirs, handling Claude Code's per-project structure
+  function expandPath(p) {
+    if (!fs.existsSync(p)) return;
+    const stat = fs.statSync(p);
+    if (!stat.isDirectory()) return;
+    // Claude Code: ~/.claude/projects contains per-project subdirs with JSONL files
+    if (p.replace(/\/$/, '').endsWith('/.claude/projects')) {
+      for (const proj of fs.readdirSync(p)) {
+        const projDir = path.join(p, proj);
+        if (fs.statSync(projDir).isDirectory()) {
+          const hasJsonl = fs.readdirSync(projDir).some(f => f.endsWith('.jsonl'));
+          if (hasJsonl) dirs.push({ path: projDir, agent: 'claude-code' });
+        }
+      }
+    } else {
+      dirs.push({ path: p, agent: path.basename(path.dirname(p)) });
+    }
+  }
+
   // Config sessionsPath or env var override
   const sessionsOverride = process.env.AGENTACTA_SESSIONS_PATH || (config && config.sessionsPath);
   if (sessionsOverride) {
-    for (const p of sessionsOverride.split(':')) {
-      if (fs.existsSync(p)) dirs.push({ path: p, agent: path.basename(path.dirname(p)) });
-    }
+    const overridePaths = Array.isArray(sessionsOverride)
+      ? sessionsOverride
+      : sessionsOverride.split(':');
+    overridePaths.forEach(expandPath);
     if (dirs.length) return dirs;
   }
 
-  // Scan ~/.openclaw/agents/*/sessions/
+  // Auto-discover: ~/.openclaw/agents/*/sessions/
   const oclawAgents = path.join(home, '.openclaw/agents');
   if (fs.existsSync(oclawAgents)) {
     for (const agent of fs.readdirSync(oclawAgents)) {
@@ -49,23 +69,8 @@ function discoverSessionDirs(config) {
     }
   }
 
-  // Scan ~/.claude/projects/*/ (Claude Code stores JSONL directly in project dirs)
-  const claudeProjects = path.join(home, '.claude/projects');
-  if (fs.existsSync(claudeProjects)) {
-    for (const proj of fs.readdirSync(claudeProjects)) {
-      const projDir = path.join(claudeProjects, proj);
-      // Claude Code: JSONL files directly in project dir
-      if (fs.existsSync(projDir) && fs.statSync(projDir).isDirectory()) {
-        const hasJsonl = fs.readdirSync(projDir).some(f => f.endsWith('.jsonl'));
-        if (hasJsonl) dirs.push({ path: projDir, agent: 'claude-code' });
-      }
-      // Also check sessions/ subdirectory (future-proofing)
-      const sp = path.join(projDir, 'sessions');
-      if (fs.existsSync(sp) && fs.statSync(sp).isDirectory()) {
-        dirs.push({ path: sp, agent: 'claude-code' });
-      }
-    }
-  }
+  // Auto-discover: ~/.claude/projects/
+  expandPath(path.join(home, '.claude/projects'));
 
   // Scan ~/.codex/sessions recursively (Codex CLI stores nested YYYY/MM/DD/*.jsonl)
   const codexSessions = path.join(home, '.codex/sessions');
@@ -289,11 +294,16 @@ function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
     if (firstLine.agent) agent = firstLine.agent;
     if (firstLine.sessionType) sessionType = firstLine.sessionType;
     if (sessionId.includes('subagent')) sessionType = 'subagent';
-  } else if (firstLine.type === 'user' || firstLine.type === 'assistant' || firstLine.type === 'file-history-snapshot') {
-    // Claude Code format — no session header, extract from first message line
+  } else if (firstLine.type === 'user' || firstLine.type === 'assistant' || firstLine.type === 'file-history-snapshot' || firstLine.type === 'queue-operation') {
+    // Claude Code format — no session header, extract from first message or queue-operation line
     isClaudeCode = true;
     for (const line of lines) {
       let obj; try { obj = JSON.parse(line); } catch { continue; }
+      if (obj.sessionId && obj.timestamp) {
+        sessionId = obj.sessionId;
+        sessionStart = obj.timestamp;
+        break;
+      }
       if ((obj.type === 'user' || obj.type === 'assistant') && obj.sessionId) {
         sessionId = obj.sessionId;
         sessionStart = obj.timestamp;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentacta",
-  "version": "2026.3.5",
+  "version": "2026.3.7",
   "description": "Audit trail and search engine for AI agent sessions",
   "main": "index.js",
   "bin": {

package/public/app.js

@@ -1148,6 +1148,14 @@ async function viewStats() {
     ${data.agents && data.agents.length > 1 ? `<div class="section-label">Agents</div><div class="filters" style="margin-bottom:var(--space-xl)">${data.agents.map(a => `<span class="filter-chip">${escHtml(a)}</span>`).join('')}</div>` : ''}
     <div class="section-label">Tools Used</div>
     <div class="tools-grid">${[...new Set((data.tools||[]).filter(t => t).map(t => fmtToolGroup(t)))].sort().map(t => `<span class="tool-chip">${escHtml(t)}</span>`).join('')}</div>
+
+    <div class="section-label">System Info</div>
+    <div id="systemInfoContainer" style="display:grid;grid-template-columns:repeat(auto-fit, minmax(220px, 1fr));gap:var(--space-md);margin-bottom:var(--space-md)">
+      <div class="config-card"><div class="config-label">Version</div><div class="config-value" id="sysVersion">…</div></div>
+      <div class="config-card"><div class="config-label">Uptime</div><div class="config-value" id="sysUptime">…</div></div>
+      <div class="config-card"><div class="config-label">Indexed Sessions</div><div class="config-value" id="sysSessions">…</div></div>
+      <div class="config-card"><div class="config-label">Node.js</div><div class="config-value" id="sysNode">…</div></div>
+    </div>
   </div>`;
 
   content.innerHTML = html;
@@ -1187,6 +1195,31 @@ async function viewStats() {
       optimizeBtn.disabled = false;
     });
   }
+
+  // Fetch system info
+  api('/health').then(h => {
+    if (h._error) return;
+    const fmtUptime = (s) => {
+      const d = Math.floor(s / 86400);
+      const hr = Math.floor((s % 86400) / 3600);
+      const m = Math.floor((s % 3600) / 60);
+      if (d > 0) return `${d}d ${hr}h`;
+      if (hr > 0) return `${hr}h ${m}m`;
+      return `${m}m`;
+    };
+    const fmtBytes = (b) => {
+      if (b >= 1024 * 1024) return `${(b / (1024 * 1024)).toFixed(1)} MB`;
+      return `${(b / 1024).toFixed(1)} KB`;
+    };
+    const v = $('#sysVersion');
+    const u = $('#sysUptime');
+    const sc = $('#sysSessions');
+    const n = $('#sysNode');
+    if (v) v.textContent = `v${h.version}`;
+    if (u) u.textContent = fmtUptime(h.uptime);
+    if (sc) sc.textContent = String(h.sessions);
+    if (n) n.textContent = h.node;
+  });
 }
 
 async function viewFiles() {