mnueron 0.3.0 → 0.5.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="assets/promo-large-dark.png" alt="mnueron — memory for every AI" width="420" />
+  <img src="https://raw.githubusercontent.com/randi2160/mnueron/main/assets/promo-large-dark.png" alt="mnueron — memory for every AI" width="420" />
 </p>
 
 <p align="center"><strong>One memory layer. Every LLM. Every dev tool. Every app you build.</strong></p>
@@ -36,6 +36,22 @@ What changes day-to-day:
 - **In your apps:** When a user comes back, the AI already knows their preferences — without you wiring it up per-provider.
 - **Across providers:** Switch from OpenAI to Claude to Mistral without losing your customer's history. The memory layer is the constant.
 
+## What's new
+
+See [CHANGELOG.md](CHANGELOG.md) for the full history. Headlines:
+
+- **`mnueron primer`** — emit a CLAUDE.md / cursorrules-style memory primer (`mnueron primer > CLAUDE.md`)
+- **5 more IDE detectors** — Continue, Zed, Aider, Goose, OpenCode
+- **Platform API gaps closed** — date-range filter, PATCH update, bulk search, metadata-field filter
+- **Webhook subscriptions** — HMAC-signed POSTs on memory events
+- **Fact extraction** — long assistant responses get distilled into searchable facts
+- **Backend secret redaction** — defense in depth on top of the client-side redactor
+- **Chrome extension v0.2.0** — Local/Hosted toggle, recall + inject, ambient context, build-prompt multi-select
+- **SDKs refreshed** — Python `0.3.1` + .NET `0.3` cover the new endpoints (date filters, PATCH, bulk search, webhook CRUD, HMAC verifier)
+- **Claude Desktop import** — `mnueron import --claude-desktop` probes for and ingests Claude Desktop's export JSON
+
+Full API docs at [mnueron.com/docs/api/overview](https://mnueron.com/docs/api/overview).
+
 ## What you get out of the box — free, forever
 
 Run `mnueron setup` and every single one of these is yours. No account, no credit card, no telemetry. Your data lives at `~/.mnueron/memories.db` and never leaves your computer unless you explicitly opt into hosted mode.
@@ -162,6 +178,112 @@ mnueron import ~/Downloads/conversations.json --ns my-project
 Auto-detects Claude vs OpenAI format. Each conversation becomes a searchable
 memory tagged `imported`.
 
+### Import your Claude Cowork sessions
+
+If you use Claude's "Cowork" mode (the desktop app's local agent mode), every
+chat is already on disk as a JSONL transcript. mnueron can find and import
+all of them with no export step.
+
+#### CLI — one-shot import
+
+```bash
+# See what would be imported without saving anything
+mnueron import --claude-cowork --probe
+
+# Import every Cowork session into the default namespace ("claude-cowork")
+mnueron import --claude-cowork
+
+# Import into a custom namespace (e.g. group with one of your projects)
+mnueron import --claude-cowork --ns elevizio
+
+# Only import the 10 most recent Cowork sessions
+mnueron import --claude-cowork --limit 10 --ns elevizio
+
+# Parse everything but do NOT save — useful to confirm the parse is clean
+mnueron import --claude-cowork --dry-run
+```
+
+Re-runs are safe: each session is upserted by `source_ref="cowork:<sessionId>"`,
+so importing twice just refreshes any sessions whose transcripts have changed.
+
+Where mnueron looks for transcripts:
+
+| OS | Paths scanned |
+|---|---|
+| Windows (regular install) | `%APPDATA%\Claude\local-agent-mode-sessions\` |
+| Windows (Microsoft Store install) | `%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\local-agent-mode-sessions\` |
+| macOS | `~/Library/Application Support/Claude/local-agent-mode-sessions/` |
+| Linux | `~/.config/Claude/local-agent-mode-sessions/` |
+| All | `~/.claude/projects/` (regular Claude Code) |
+
+Each Cowork session becomes one memory. The chunker then splits long
+transcripts per-turn so search returns the specific exchange, not the whole
+6000-message session.
+
+#### CLI — background watcher
+
+Long-running mode: keeps Cowork in step with mnueron memory by re-importing
+any session whose transcript file changes.
+
+```bash
+# Default: poll every 5 minutes, save into the "claude-cowork" namespace,
+# run forever (Ctrl+C to stop).
+mnueron watch --claude-cowork
+
+# Custom interval (poll every 2 minutes) and namespace
+mnueron watch --claude-cowork --interval 2 --ns elevizio
+
+# Run exactly one sync tick and exit — useful for cron / Task Scheduler
+mnueron watch --claude-cowork --once
+```
+
+The watcher persists last-synced mtimes per session at
+`~/.mnueron/cowork-sync.json`, so restarting it doesn't re-import everything.
+
+#### Dashboard — one-click import
+
+```bash
+# Open the dashboard at localhost:3122 in your browser
+mnueron dashboard
+```
+
+Then click the **Import Cowork** button in the toolbar (next to the existing
+**Import…** button). You'll get a confirmation showing the session and
+message count before the import runs.
+
+#### MCP — trigger from inside any Claude session
+
+mnueron's MCP server exposes a `memory_import_cowork` tool. Once mnueron is
+wired into Claude Desktop / Claude Code (`mnueron setup`), just say:
+
+> "Import my cowork chats."
+
+Claude will call the tool with sensible defaults. To pass specific options:
+
+> "Use the `memory_import_cowork` tool with `namespace="elevizio"` and `limit=5`."
+
+The tool accepts:
+- `namespace` (string, default `"claude-cowork"`) — where to save the memories
+- `limit` (number, optional) — cap how many sessions to import in this call
+- `probe_only` (boolean, default `false`) — report what would be imported, don't save
+
+#### Daily scheduled task
+
+The Claude desktop app's scheduled-tasks feature can run the import on a
+cron. Example: every weekday at 7am.
+
+- Cron expression: `0 7 * * 1-5`
+- Prompt for the scheduled task:
+
+  ```
+  Run the daily mnueron Cowork sync by calling the memory_import_cowork
+  MCP tool with no arguments. Report a one-line digest of saved chunks
+  vs total sessions.
+  ```
+
+This runs while the Claude app is open; if it's closed when the task is
+due, it fires on next launch.
+
 ## Use it in your apps (Python)
 
 ```bash

package/dashboard/index.html

@@ -349,6 +349,7 @@
       <span class="scope" id="scope">all namespaces</span>
       <button class="btn" id="import-btn">Import…</button>
       <input type="file" id="import-file" accept=".json" style="display:none" />
+      <button class="btn" id="import-cowork-btn" title="Import every Claude Cowork (local-agent-mode) chat from this machine">Import Cowork</button>
     </div>
 
     <div class="list-body" id="list">
@@ -726,6 +727,42 @@
   }
 
   // ─── import ───────────────────────────────────────────────────────────
+  async function importCowork() {
+    try {
+      toast('Probing for Cowork sessions…');
+      const probe = await api('/api/import/claude-cowork');
+      if (!probe || !probe.found || (probe.sessions ?? []).length === 0) {
+        const where = (probe?.scanned_roots ?? []).length
+          ? `Scanned ${probe.scanned_roots.length} root(s) but found no transcripts.`
+          : 'No Cowork install detected on this machine.';
+        toast(where + ' Try running Cowork once first.', 'err');
+        return;
+      }
+      const n = probe.sessions.length;
+      const totalMsgs = probe.sessions.reduce((a, s) => a + (s.message_count ?? 0), 0);
+      const ok = window.confirm(
+        `Import ${n} Cowork session${n === 1 ? '' : 's'} (${totalMsgs.toLocaleString()} messages) ` +
+        `into the "claude-cowork" namespace?\n\nIdempotent — safe to re-run.`,
+      );
+      if (!ok) return;
+      toast(`Importing ${n} session${n === 1 ? '' : 's'}…`);
+      const res = await api('/api/import/claude-cowork', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ namespace: 'claude-cowork' }),
+      });
+      const saved = res.saved ?? 0;
+      const errs = res.errors ?? 0;
+      toast(
+        `Imported ${saved} memory chunk${saved === 1 ? '' : 's'} from ${res.parsed ?? n} session(s)` +
+        (errs ? ` — ${errs} error${errs === 1 ? '' : 's'}` : '') +
+        ` (namespace "${res.namespace}").`,
+        errs ? 'err' : 'ok',
+      );
+      await Promise.all([loadList(), loadNamespaces(), loadStats()]);
+    } catch (e) { toast('cowork import failed: ' + e.message, 'err'); }
+  }
+
   async function importFile(file) {
     try {
       const text = await file.text();
@@ -768,6 +805,7 @@
     if (f) importFile(f);
     e.target.value = '';
   });
+  document.getElementById('import-cowork-btn').addEventListener('click', importCowork);
 
   // Drag-drop import
   const drop = document.getElementById('drop');