nexus-prime 3.12.1 → 3.14.0

package/README.md

@@ -1,11 +1,11 @@
 <div align="center">
-  <h1>🧬 Nexus Prime</h1>
+  <img src="./docs/assets/nexus-prime-logo.svg" alt="Nexus Prime" width="80" height="80">
+  <h1>Nexus Prime</h1>
   <p><strong>Local-first MCP control plane for coding agents</strong></p>
 
   [![npm version](https://img.shields.io/npm/v/nexus-prime?style=for-the-badge&color=00ff88)](https://www.npmjs.com/package/nexus-prime)
   [![npm downloads](https://img.shields.io/npm/d18m/nexus-prime?style=for-the-badge&color=00d4ff)](https://www.npmjs.com/package/nexus-prime)
   [![License: MIT](https://img.shields.io/badge/License-MIT-00d4ff?style=for-the-badge)](LICENSE)
-  [![Agentic OS](https://img.shields.io/badge/Ecosystem-Agentic_OS-8b5cf6?style=for-the-badge)](https://github.com/topics/agentic-os)
   [![Build Status](https://img.shields.io/badge/build-passing-success?style=for-the-badge)](https://github.com/sir-ad/nexus-prime/actions)
   [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=node.js)](https://nodejs.org)
   <!-- traffic-badges:start -->
@@ -13,11 +13,25 @@
   [![Clones](https://img.shields.io/endpoint?style=for-the-badge&logo=github&url=https%3A%2F%2Fgist.githubusercontent.com%2Fsir-ad%2Fbbf9ebc77ccb2097ccf760bec3825ab7%2Fraw%2Fclones.json)](https://github.com/sir-ad/nexus-prime)
   <!-- traffic-badges:end -->
 
+  [![GitHub Stars](https://img.shields.io/github/stars/sir-ad/nexus-prime?style=for-the-badge&logo=github&color=gold)](https://github.com/sir-ad/nexus-prime/stargazers)
+  [![GitHub Forks](https://img.shields.io/github/forks/sir-ad/nexus-prime?style=for-the-badge&logo=github&color=silver)](https://github.com/sir-ad/nexus-prime/network/members)
+  [![GitHub Issues](https://img.shields.io/github/issues/sir-ad/nexus-prime?style=for-the-badge&color=orange)](https://github.com/sir-ad/nexus-prime/issues)
+  [![GitHub Last Commit](https://img.shields.io/github/last-commit/sir-ad/nexus-prime?style=for-the-badge&color=00ff88)](https://github.com/sir-ad/nexus-prime/commits)
+  [![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen?style=for-the-badge)](https://github.com/sir-ad/nexus-prime/pulls)
+
   <!-- AI / Agentic Widgets -->
   [![AI Framework](https://img.shields.io/badge/AI-Framework-FF9900?style=for-the-badge)](https://github.com/topics/ai)
   [![LLM Ready](https://img.shields.io/badge/LLM-Ready-00A67E?style=for-the-badge)](https://github.com/topics/llm)
   [![MCP Protocol](https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge)](https://modelcontextprotocol.io/)
-  
+  [![Agentic OS](https://img.shields.io/badge/Ecosystem-Agentic_OS-8b5cf6?style=for-the-badge)](https://github.com/topics/agentic-os)
+  [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+  [![Open Source](https://img.shields.io/badge/Open_Source-%E2%9D%A4-red?style=for-the-badge)](https://opensource.org/)
+
+  <!-- Community -->
+  [![Reddit #1 Post](https://img.shields.io/badge/r%2FLLMDevs-%231_Post_of_the_Day-FF4500?style=for-the-badge&logo=reddit&logoColor=white)](https://www.reddit.com/r/LLMDevs/)
+  [![Reddit Community](https://img.shields.io/badge/Reddit-r%2FNexus__Prime-FF4500?style=for-the-badge&logo=reddit&logoColor=white)](https://www.reddit.com/r/Nexus_Prime/)
+  [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/zCPEjPZj)
+
   <p><i>Bootstrap. Orchestrate. Verify. Learn.</i></p>
   <a href="https://www.producthunt.com/products/nexus-prime?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime - Semantic memory and parallel execution for AI coding agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&amp;theme=dark&amp;t=1773345508816"></a>
 
@@ -66,6 +80,34 @@ npx nexus-prime mcp
 
 Home-scoped bootstrap now runs automatically on install or first binary start, and the first Nexus run inside a repo writes the workspace-scoped client files it needs. `nexus-prime setup <client>` and `nexus-prime setup all` remain the explicit refresh/fix path when you want to force regeneration.
 
+### Docker
+
+```bash
+docker compose up                              # Nexus Prime only
+docker compose --profile with-ollama up        # Nexus Prime + local Ollama
+```
+
+### Embedding backends
+
+Nexus Prime supports multiple embedding backends with automatic fallback:
+
+| Backend | Config | Default model |
+|---------|--------|---------------|
+| **Local TF-IDF** | `NEXUS_EMBED_MODE=local` (default) | Built-in 128-dim |
+| **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` |
+| **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `sentence-transformers/all-MiniLM-L6-v2` |
+| **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` |
+
+```bash
+# Ollama (requires ollama running locally)
+NEXUS_EMBED_MODE=ollama NEXUS_OLLAMA_ENDPOINT=http://localhost:11434 npx nexus-prime mcp
+
+# HuggingFace Inference API
+NEXUS_EMBED_MODE=huggingface NEXUS_HF_API_KEY=hf_... npx nexus-prime mcp
+```
+
+Fallback chain: Ollama → HuggingFace → OpenAI → Local TF-IDF. If the preferred backend is unavailable, Nexus falls through automatically.
+
 ## Default bootstrap-orchestrate path
 
 ```txt
@@ -174,15 +216,18 @@ flowchart TD
 ## 🚀 Client Setup and Runtime Contract
 
 ### Supported MCP Clients
-Nexus Prime currently provides automated setup for:
+Nexus Prime provides automated setup for **9 coding agents**:
 - 🔴 **Codex**
 - 🔵 **Cursor**
 - 🍊 **Claude Code**
 - 🟢 **Opencode**
 - 🌊 **Windsurf**
 - 🛡️ **Antigravity / OpenClaw**
+- 🔧 **Aider**
+- 🔗 **Continue.dev**
+- ⚙️ **Cline**
 
-Codex now has a first-class setup path too: `nexus-prime setup codex` creates or updates a managed Nexus Prime bootstrap block inside the repo-local `AGENTS.md`. Manual copying is no longer required; Nexus also auto-establishes home-scoped bootstrap on install/start and writes workspace-scoped client files on first repo run.
+All agent configurations are written automatically on `npm install`. The first Nexus run inside a repo writes workspace-scoped client files. `nexus-prime setup <client>` and `nexus-prime setup all` remain the explicit refresh/fix path.
 
 ### Automated Integration
 ```bash
@@ -191,6 +236,9 @@ nexus-prime setup cursor
 nexus-prime setup claude
 nexus-prime setup windsurf
 nexus-prime setup antigravity
+nexus-prime setup aider
+nexus-prime setup continue
+nexus-prime setup cline
 nexus-prime setup all
 nexus-prime setup status
 ```
@@ -573,6 +621,36 @@ Inventory Snapshot: 109 skills · 64 workflows · 5 hooks · 3 automations · 7
 ## 📜 Release History
 
 <details open>
+<summary><b>v3.14.0</b> · 2026-03-16 · Ollama/HuggingFace embeddings, autonomous memory, agent ecosystem expansion</summary>
+
+- **Embedding backend chain**: Added Ollama and HuggingFace Inference API as embedding backends with automatic fallback (Ollama → HuggingFace → OpenAI → Local TF-IDF).
+- **Agent ecosystem expansion**: Added first-class setup for Aider, Continue.dev, and Cline alongside existing Codex, Cursor, Claude Code, Opencode, Windsurf, and OpenClaw adapters (9 agents total).
+- **OpenClaw memory bridge**: Bidirectional memory sync between Nexus Prime and OpenClaw instances via `nexus_openclaw_memory_sync`.
+- **Autonomous memory management**: Configurable decay rates, access-frequency retention (frequently recalled memories decay slower), and a maintenance cycle that expires stale low-value memories.
+- **Learning-to-skill promotion**: Recurring agent learnings are automatically promoted to reusable skills when access patterns indicate reliability.
+- **Fuzzy skill matching**: Skill resolution now uses Jaccard similarity scoring instead of exact name matching, so approximate goal text finds relevant skills.
+- **Adaptive token optimization**: Reading plan thresholds adjust dynamically based on file count and budget constraints.
+- **Docker one-click install**: `docker compose up` starts Nexus Prime; `--profile with-ollama` adds local Ollama for fully offline operation.
+- **Fixed**: Dashboard memory graph no longer overlaps text (z-index stacking). Claude Code MCP config path corrected to `~/.claude/mcp.json`. Agent auto-config now writes workspace configs during `npm install`.
+
+Full notes: [CHANGELOG.md](./CHANGELOG.md)
+</details>
+
+<details>
+<summary><b>v3.13.0</b> · 2026-03-15 · Workspace surfaces, dashboard layout fixes, and community presence</summary>
+
+- Dashboard workspaces now drive their own graph visibility, library tabs, titles, and subtitles per surface mode (overview, knowledge, runs, catalog, governance).
+- Fixed memory graph overlapping text in non-graph surfaces by collapsing focusable-shell gap when the graph widget is hidden and removing conflicting inline margin.
+- Added graph-note text overflow handling and responsive min-height for hidden-graph surfaces.
+- Library tabs are now rendered dynamically per workspace instead of a single hardcoded rail.
+- Knowledge workspace auto-opens the create form when no collections exist.
+- Plan and execute actions now switch to the runs workspace automatically.
+- Added community badges (Reddit, Discord), engagement badges (stars, forks, issues, PRs), and the r/LLMDevs #1 Post of the Day recognition.
+
+Full notes: [CHANGELOG.md](./CHANGELOG.md)
+</details>
+
+<details>
 <summary><b>v3.12.1</b> · 2026-03-14 · Dashboard focus mode, graph recall wiring, and bootstrap recovery</summary>
 
 - Added dashboard maximize/restore focus mode across the main operational panels so graph, memory snapshots, runtime events, and operator actions are usable without the cramped default layout.

package/dist/agents/adapters/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgE5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAC5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAgKF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAElC,OAAO,CAAC,GAAG;;IAmBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,uBAAuB;IAsB/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAixB5B,OAAO,CAAC,2BAA2B;IAUnC,OAAO,CAAC,iBAAiB;YAsCX,cAAc;IA0wD5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CACzC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgE5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAC5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAiKF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAElC,OAAO,CAAC,GAAG;;IAmBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,uBAAuB;IAsB/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IA+xB5B,OAAO,CAAC,2BAA2B;IAUnC,OAAO,CAAC,iBAAiB;YAsCX,cAAc;IA0zD5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CACzC"}

package/dist/agents/adapters/mcp.js

@@ -119,6 +119,7 @@ const MANUAL_OR_DIAGNOSTIC_TOOLS = new Set([
     'nexus_pattern_search',
     'nexus_pattern_list',
     'nexus_knowledge_provenance',
+    'nexus_openclaw_memory_sync',
 ]);
 /** Session-level telemetry tracker */
 class SessionTelemetry {
@@ -408,6 +409,20 @@ export class MCPAdapter {
                 description: 'Expert surface: run memory maintenance to expire TTL memories, cool stale entries, and quarantine or scrap low-signal items.',
                 inputSchema: { type: 'object', properties: {}, required: [] },
             },
+            {
+                name: 'nexus_openclaw_memory_sync',
+                description: 'Expert surface: sync memory to/from OpenClaw/Antigravity instances. Use "syncTo" to export memory bundle to target directory, "syncFrom" to import from source directory.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        action: { type: 'string', enum: ['syncTo', 'syncFrom', 'status'], description: 'The sync action to perform' },
+                        targetDir: { type: 'string', description: 'Target directory for syncTo (e.g. ~/.antigravity/nexus-prime/)' },
+                        sourceDir: { type: 'string', description: 'Source directory for syncFrom' },
+                        scope: { type: 'string', enum: ['session', 'project', 'user', 'promoted', 'shared'], description: 'Memory scope for syncTo' },
+                    },
+                    required: ['action'],
+                },
+            },
             {
                 name: 'nexus_memory_trace',
                 description: 'Expert surface: inspect one memory item with lineage, backlinks, and reconciliation details.',
@@ -1555,6 +1570,50 @@ export class MCPAdapter {
                         }],
                 };
             }
+            case 'nexus_openclaw_memory_sync': {
+                const action = String(request.params.arguments?.action ?? 'status');
+                const targetDir = String(request.params.arguments?.targetDir ?? '');
+                const sourceDir = String(request.params.arguments?.sourceDir ?? '');
+                const scope = String(request.params.arguments?.scope ?? 'session');
+                const { MemoryBridge } = await import('../../engines/memory-bridge.js');
+                const { MemoryEngine } = await import('../../engines/memory.js');
+                const memoryEngine = new MemoryEngine();
+                const bridge = new MemoryBridge(memoryEngine);
+                let detail;
+                if (action === 'syncTo') {
+                    const result = bridge.syncTo(targetDir || bridge.getBridgeDir(), { scope });
+                    detail = formatBullets([
+                        `Success: ${result.success}`,
+                        `Items: ${result.itemCount}`,
+                        result.path ? `Path: ${result.path}` : '',
+                    ]);
+                }
+                else if (action === 'syncFrom') {
+                    const result = bridge.syncFrom(sourceDir || bridge.getBridgeDir());
+                    detail = formatBullets([
+                        `Success: ${result.success}`,
+                        `Items: ${result.itemCount}`,
+                        result.errors?.length ? `Errors: ${result.errors.join(', ')}` : '',
+                    ]);
+                }
+                else {
+                    const result = bridge.getSyncState();
+                    detail = formatBullets([
+                        `Last sync: ${result.lastSync ? new Date(result.lastSync).toISOString() : 'never'}`,
+                        `Direction: ${result.lastDirection || 'none'}`,
+                        `Items: ${result.lastItemCount}`,
+                    ]);
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: [
+                                `OpenClaw memory sync: ${action}`,
+                                detail,
+                            ].join('\n\n'),
+                        }],
+                };
+            }
             case 'nexus_memory_trace': {
                 const id = String(request.params.arguments?.id ?? '');
                 const detail = this.nexusRef.traceMemory(id);