cogpit-memory 0.1.2 → 0.1.4

package/README.md

@@ -40,14 +40,14 @@ cogpit-memory search "authentication"
 cogpit-memory sessions                              # Recent sessions (last 7 days)
 cogpit-memory sessions --cwd /path/to/project       # Filter by project
 cogpit-memory sessions --current --cwd /path/to/project  # Most recent for a project
-cogpit-memory sessions --max-age 30d --limit 50     # Custom window
+cogpit-memory sessions --max-age 90d --limit 50     # Custom window
 ```
 
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--cwd` | all | Filter by working directory |
 | `--limit` | `20` | Max results |
-| `--max-age` | `7d` | Time window (`7d`, `12h`, `30d`) |
+| `--max-age` | `7d` | Time window — any duration (`7d`, `12h`, `90d`, `365d`) |
 | `--current` | — | Most recent session for `--cwd` |
 
 ### `context` — Layered session drill-down
@@ -77,11 +77,11 @@ cogpit-memory search "AuthProvider" --case-sensitive          # Case-sensitive
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--session` | all | Scope to single session |
-| `--max-age` | `5d` | Time window |
+| `--max-age` | `5d` | Time window — any duration (`5d`, `30d`, `365d`) |
 | `--limit` | `20` | Max returned hits |
 | `--case-sensitive` | `false` | Case sensitivity |
 
-Each hit includes a `location` string (e.g. `turn/3/assistantMessage`, `agent/a7f3bc2/toolCall/tc1/result`) that maps directly to L2/L3 drill-down commands.
+Each result includes the `cwd` (working directory where the session ran) and an array of hits. Each hit includes a `location` string (e.g. `turn/3/assistantMessage`, `agent/a7f3bc2/toolCall/tc1/result`) that maps directly to L2/L3 drill-down commands.
 
 ### `index` — Manage the FTS5 search index
 
@@ -135,19 +135,34 @@ bun run build
 bun run build:npm
 ```
 
-## Claude Code Skill
+## Agent Skill
 
-cogpit-memory ships with a [Claude Code skill](https://docs.anthropic.com/en/docs/claude-code/skills) that teaches Claude how to use it automatically — layered drill-down, search workflows, and all command options.
+cogpit-memory ships with a skill that teaches AI agents how to use it automatically — layered drill-down, search workflows, and all command options. Works with Claude Code, Cursor, Gemini CLI, GitHub Copilot, and more.
+
+### Install via Skills CLI (recommended)
+
+Installs globally across all supported agents:
+
+```bash
+npx skills add gentritbiba/cogpit-memory -g -y
+```
+
+Browse at [skills.sh](https://skills.sh).
+
+### Install via cogpit-memory CLI
 
 ```bash
-# Install the skill into the current project
+# Install globally (all projects)
+npx cogpit-memory install-skill -g
+
+# Install into a single project's .claude/skills/
 npx cogpit-memory install-skill
 
 # Or specify a project directory
 npx cogpit-memory install-skill --cwd /path/to/project
 ```
 
-This creates `.claude/skills/cogpit-memory/SKILL.md` in your project. Once installed, Claude Code will automatically use `cogpit-memory` when it needs to recall past session context or search conversation history.
+Once installed, your AI agent will automatically use `cogpit-memory` when it needs to recall past session context or search conversation history.
 
 ## License
 

package/dist/cli.js

@@ -812,8 +812,8 @@ var SearchIndex = class {
     const caseSensitive = opts?.caseSensitive ?? false;
     const ftsQuery = `"${query.replace(/"/g, '""')}"`;
     let sql = `
-      SELECT sc.session_id, sc.location,
-             snippet(search_content, 3, '', '', '...', 40) as snippet
+      SELECT sc.session_id, sc.source_file, sc.location,
+             snippet(search_content, 3, '', '', '...', 120) as snippet
       FROM search_content sc
     `;
     const params = [];
@@ -835,6 +835,7 @@ var SearchIndex = class {
     const rows = this.db.prepare(sql).all(...params);
     let hits = rows.map((row) => ({
       sessionId: row.session_id,
+      filePath: row.source_file,
       location: row.location,
       snippet: row.snippet,
       matchCount: 1
@@ -1213,20 +1214,21 @@ async function searchSessions(query, opts, searchIndex) {
       });
       const grouped = /* @__PURE__ */ new Map();
       for (const hit of hits) {
-        let sessionHits = grouped.get(hit.sessionId);
-        if (!sessionHits) {
-          sessionHits = [];
-          grouped.set(hit.sessionId, sessionHits);
+        let entry = grouped.get(hit.sessionId);
+        if (!entry) {
+          entry = { filePath: hit.filePath, hits: [] };
+          grouped.set(hit.sessionId, entry);
         }
-        sessionHits.push({
+        entry.hits.push({
           location: hit.location,
           snippet: hit.snippet,
           matchCount: hit.matchCount
         });
       }
       const results = [];
-      for (const [sid, sessionHits] of grouped) {
-        results.push({ sessionId: sid, hits: sessionHits });
+      for (const [sid, entry] of grouped) {
+        const cwd = await cwdFromFilePath(entry.filePath);
+        results.push({ sessionId: sid, cwd, hits: entry.hits });
       }
       let totalHits = hits.length;
       let sessionsSearched = grouped.size;
@@ -1252,6 +1254,37 @@ async function searchSessions(query, opts, searchIndex) {
   }
   return rawScanSearch(query, opts.sessionId ?? null, maxAgeMs, limit, caseSensitive, depth);
 }
+var CWD_READ_BYTES = 4096;
+var cwdCache = /* @__PURE__ */ new Map();
+async function cwdFromFilePath(filePath) {
+  const cached = cwdCache.get(filePath);
+  if (cached !== void 0) return cached;
+  try {
+    const fh = await (0, import_promises2.open)(filePath, "r");
+    try {
+      const buf = Buffer.alloc(CWD_READ_BYTES);
+      const { bytesRead } = await fh.read(buf, 0, CWD_READ_BYTES, 0);
+      const head = buf.subarray(0, bytesRead).toString("utf-8");
+      const lines = head.split("\n", 10);
+      for (const line of lines) {
+        if (!line) continue;
+        try {
+          const obj = JSON.parse(line);
+          if (obj.cwd) {
+            cwdCache.set(filePath, obj.cwd);
+            return obj.cwd;
+          }
+        } catch {
+        }
+      }
+    } finally {
+      await fh.close();
+    }
+  } catch {
+  }
+  cwdCache.set(filePath, "");
+  return "";
+}
 var SNIPPET_WINDOW = 150;
 function generateSnippet(text, matchIdx, queryLen) {
   if (matchIdx === -1) return text.slice(0, SNIPPET_WINDOW);
@@ -1450,6 +1483,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       totalHits += allHits.length;
       const sessionResult = {
         sessionId: session.sessionId || (0, import_node_path4.basename)(file.path, ".jsonl"),
+        cwd: session.cwd || "",
         hits: []
       };
       for (const hit of allHits) {
@@ -1980,6 +2014,7 @@ async function listSessions(opts = {}) {
       if (opts.cwd && meta.cwd !== opts.cwd) continue;
       results.push({
         sessionId: meta.sessionId,
+        filePath: file.path,
         timestamp: meta.timestamp,
         model: meta.model,
         cwd: meta.cwd,
@@ -2028,6 +2063,7 @@ async function currentSession(cwd) {
   ]);
   return {
     sessionId: meta.sessionId,
+    filePath: latest.path,
     timestamp: meta.timestamp,
     model: meta.model,
     cwd: meta.cwd,
@@ -2091,9 +2127,9 @@ function findSkillContent() {
   }
   throw new Error("Could not find SKILL.md \u2014 try reinstalling cogpit-memory");
 }
-function installSkill(cwd) {
-  const root = cwd ?? process.cwd();
-  const skillDir = (0, import_node_path8.join)(root, ".claude", "skills", "cogpit-memory");
+function installSkill(cwd, global) {
+  const root = global ? (0, import_node_path8.join)(process.env.HOME ?? process.env.USERPROFILE ?? "~", ".claude") : (0, import_node_path8.join)(cwd ?? process.cwd(), ".claude");
+  const skillDir = (0, import_node_path8.join)(root, "skills", "cogpit-memory");
   (0, import_node_fs4.mkdirSync)(skillDir, { recursive: true });
   const content = findSkillContent();
   const dest = (0, import_node_path8.join)(skillDir, "SKILL.md");
@@ -2169,6 +2205,10 @@ function parseArgs(argv) {
           case "--cwd":
             args.cwd = argv[++i];
             break;
+          case "-g":
+          case "--global":
+            args.global = true;
+            break;
         }
       }
       break;
@@ -2231,7 +2271,7 @@ async function main() {
       }
       break;
     case "install-skill":
-      result = installSkill(cmd.args.cwd);
+      result = installSkill(cmd.args.cwd, cmd.args.global);
       break;
     default:
       console.error(JSON.stringify({ error: `Unknown command: ${cmd.command}` }));
@@ -2263,7 +2303,9 @@ Commands:
   index stats                 Show index stats
   index rebuild               Rebuild full index
 
-  install-skill [--cwd path]  Install Claude Code skill to .claude/skills/
+  install-skill [options]      Install Claude Code skill
+    --cwd <path>              Target project directory
+    -g, --global              Install to ~/.claude/skills/ (all projects)
 `);
 }
 var isBunCompiled = false;

package/dist/index.js

@@ -898,8 +898,8 @@ var SearchIndex = class {
     const caseSensitive = opts?.caseSensitive ?? false;
     const ftsQuery = `"${query.replace(/"/g, '""')}"`;
     let sql = `
-      SELECT sc.session_id, sc.location,
-             snippet(search_content, 3, '', '', '...', 40) as snippet
+      SELECT sc.session_id, sc.source_file, sc.location,
+             snippet(search_content, 3, '', '', '...', 120) as snippet
       FROM search_content sc
     `;
     const params = [];
@@ -921,6 +921,7 @@ var SearchIndex = class {
     const rows = this.db.prepare(sql).all(...params);
     let hits = rows.map((row) => ({
       sessionId: row.session_id,
+      filePath: row.source_file,
       location: row.location,
       snippet: row.snippet,
       matchCount: 1
@@ -1304,20 +1305,21 @@ async function searchSessions(query, opts, searchIndex) {
       });
       const grouped = /* @__PURE__ */ new Map();
       for (const hit of hits) {
-        let sessionHits = grouped.get(hit.sessionId);
-        if (!sessionHits) {
-          sessionHits = [];
-          grouped.set(hit.sessionId, sessionHits);
+        let entry = grouped.get(hit.sessionId);
+        if (!entry) {
+          entry = { filePath: hit.filePath, hits: [] };
+          grouped.set(hit.sessionId, entry);
         }
-        sessionHits.push({
+        entry.hits.push({
           location: hit.location,
           snippet: hit.snippet,
           matchCount: hit.matchCount
         });
       }
       const results = [];
-      for (const [sid, sessionHits] of grouped) {
-        results.push({ sessionId: sid, hits: sessionHits });
+      for (const [sid, entry] of grouped) {
+        const cwd = await cwdFromFilePath(entry.filePath);
+        results.push({ sessionId: sid, cwd, hits: entry.hits });
       }
       let totalHits = hits.length;
       let sessionsSearched = grouped.size;
@@ -1343,6 +1345,37 @@ async function searchSessions(query, opts, searchIndex) {
   }
   return rawScanSearch(query, opts.sessionId ?? null, maxAgeMs, limit, caseSensitive, depth);
 }
+var CWD_READ_BYTES = 4096;
+var cwdCache = /* @__PURE__ */ new Map();
+async function cwdFromFilePath(filePath) {
+  const cached = cwdCache.get(filePath);
+  if (cached !== void 0) return cached;
+  try {
+    const fh = await (0, import_promises2.open)(filePath, "r");
+    try {
+      const buf = Buffer.alloc(CWD_READ_BYTES);
+      const { bytesRead } = await fh.read(buf, 0, CWD_READ_BYTES, 0);
+      const head = buf.subarray(0, bytesRead).toString("utf-8");
+      const lines = head.split("\n", 10);
+      for (const line of lines) {
+        if (!line) continue;
+        try {
+          const obj = JSON.parse(line);
+          if (obj.cwd) {
+            cwdCache.set(filePath, obj.cwd);
+            return obj.cwd;
+          }
+        } catch {
+        }
+      }
+    } finally {
+      await fh.close();
+    }
+  } catch {
+  }
+  cwdCache.set(filePath, "");
+  return "";
+}
 var SNIPPET_WINDOW = 150;
 function generateSnippet(text, matchIdx, queryLen) {
   if (matchIdx === -1) return text.slice(0, SNIPPET_WINDOW);
@@ -1541,6 +1574,7 @@ async function rawScanSearch(query, sessionId, maxAgeMs, limit, caseSensitive, d
       totalHits += allHits.length;
       const sessionResult = {
         sessionId: session.sessionId || (0, import_node_path4.basename)(file.path, ".jsonl"),
+        cwd: session.cwd || "",
         hits: []
       };
       for (const hit of allHits) {
@@ -2071,6 +2105,7 @@ async function listSessions(opts = {}) {
       if (opts.cwd && meta.cwd !== opts.cwd) continue;
       results.push({
         sessionId: meta.sessionId,
+        filePath: file.path,
         timestamp: meta.timestamp,
         model: meta.model,
         cwd: meta.cwd,
@@ -2119,6 +2154,7 @@ async function currentSession(cwd) {
   ]);
   return {
     sessionId: meta.sessionId,
+    filePath: latest.path,
     timestamp: meta.timestamp,
     model: meta.model,
     cwd: meta.cwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cogpit-memory",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI tool for Claude Code session introspection — search, browse, and drill into past sessions",
   "main": "./dist/index.js",
   "types": "./src/index.ts",

package/skill/SKILL.md

@@ -262,6 +262,7 @@ bunx cogpit-memory search "AuthProvider" --case-sensitive
   "results": [
     {
       "sessionId": "abc-123",
+      "cwd": "/path/to/project",
       "hits": [
         {
           "location": "turn/3/userMessage",