nexus-prime 6.6.0 → 6.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +464 -113
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,185 +1,536 @@
1
1
  <div align="center">
2
- <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/nexus-prime-logo.svg" alt="Nexus Prime" width="80" height="80">
2
+ <img src="https://nexus-prime.cfd/assets/nexus-prime-logo.png" alt="Nexus Prime" width="120" height="120">
3
+
3
4
  <h1>Nexus Prime</h1>
4
- <p><strong>Local-first MCP control plane for coding agents</strong></p>
5
+ <p><strong>The control plane your coding agent has been missing.</strong></p>
6
+ <p><i>Bootstrap. Orchestrate. Verify. Learn — across every agent, every session, every repo.</i></p>
7
+
8
+ <p>
9
+ <a href="https://www.npmjs.com/package/nexus-prime"><img src="https://img.shields.io/npm/v/nexus-prime?style=for-the-badge&color=00ff88&label=npm" alt="npm version"></a>
10
+ <a href="https://www.npmjs.com/package/nexus-prime"><img src="https://img.shields.io/npm/d18m/nexus-prime?style=for-the-badge&color=00d4ff&label=downloads" alt="npm downloads"></a>
11
+ <a href="https://www.npmjs.com/package/nexus-prime"><img src="https://img.shields.io/npm/dw/nexus-prime?style=for-the-badge&color=00d4ff&label=weekly" alt="weekly downloads"></a>
12
+ <a href="https://github.com/sir-ad/nexus-prime/stargazers"><img src="https://img.shields.io/github/stars/sir-ad/nexus-prime?style=for-the-badge&color=ffd700&logo=github" alt="GitHub stars"></a>
13
+ <a href="https://github.com/sir-ad/nexus-prime/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/nexus-prime?style=for-the-badge&color=brightgreen" alt="License"></a>
14
+ </p>
15
+
16
+ <p>
17
+ <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
18
+ <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
19
+ <img src="https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge" alt="MCP">
20
+ <img src="https://img.shields.io/badge/local--first-SQLite-003B57?style=for-the-badge&logo=sqlite&logoColor=white" alt="SQLite">
21
+ <img src="https://img.shields.io/badge/zero--cloud-%E2%9C%93-00ff88?style=for-the-badge" alt="Zero Cloud">
22
+ </p>
23
+
24
+ <p>
25
+ <a href="https://github.com/sir-ad/nexus-prime/releases"><img src="https://img.shields.io/github/v/release/sir-ad/nexus-prime?style=flat-square&color=7c3aed&label=latest" alt="Latest release"></a>
26
+ <a href="https://github.com/sir-ad/nexus-prime/commits/main"><img src="https://img.shields.io/github/last-commit/sir-ad/nexus-prime?style=flat-square&color=7c3aed" alt="Last commit"></a>
27
+ <a href="https://github.com/sir-ad/nexus-prime/issues"><img src="https://img.shields.io/github/issues/sir-ad/nexus-prime?style=flat-square&color=7c3aed" alt="Issues"></a>
28
+ <a href="https://github.com/sir-ad/nexus-prime/pulls"><img src="https://img.shields.io/badge/PRs-welcome-ff69b4?style=flat-square" alt="PRs welcome"></a>
29
+ <img src="https://img.shields.io/badge/made%20with-%E2%9D%A4-red?style=flat-square" alt="Made with love">
30
+ </p>
31
+
32
+ <p>
33
+ <a href="https://www.reddit.com/r/Nexus_Prime/"><img src="https://img.shields.io/badge/Reddit-r%2FNexus__Prime-FF4500?style=for-the-badge&logo=reddit&logoColor=white" alt="Reddit"></a>
34
+ <a href="https://discord.gg/tByGZgk5gS"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
35
+ <a href="https://x.com/nexusprime_ai"><img src="https://img.shields.io/badge/Follow-%40nexusprime__ai-000000?style=for-the-badge&logo=x&logoColor=white" alt="X"></a>
36
+ </p>
37
+
38
+ <a href="https://www.producthunt.com/products/nexus-prime?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime — Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&theme=dark&t=1773345508816"></a>
39
+ </div>
5
40
 
6
- [![npm version](https://img.shields.io/npm/v/nexus-prime?style=for-the-badge&color=00ff88)](https://www.npmjs.com/package/nexus-prime)
7
- [![npm downloads](https://img.shields.io/npm/d18m/nexus-prime?style=for-the-badge&color=00d4ff)](https://www.npmjs.com/package/nexus-prime)
8
- [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=node.js)](https://nodejs.org)
9
- [![MCP Protocol](https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge)](https://modelcontextprotocol.io/)
10
- [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
41
+ > **Coding agents shipped without infrastructure. Nexus Prime is that infrastructure.**
42
+ >
43
+ > One SQLite brain. One daemon. Every agent you use. Zero cloud.
11
44
 
12
- [![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/)
13
- [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/tByGZgk5gS)
45
+ ---
14
46
 
15
- <p><i>Bootstrap. Orchestrate. Verify. Learn.</i></p>
16
- <a href="https://www.producthunt.com/products/nexus-prime?embed=true&utm_source=badge-featured&utm_medium=badge&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&theme=dark&t=1773345508816"></a>
17
- </div>
47
+ ## Contents
48
+
49
+ - [Why Nexus Prime](#why-nexus-prime)
50
+ - [Quick start](#quick-start)
51
+ - [Features](#features)
52
+ - [See it in action](#see-it-in-action)
53
+ - [How it works](#how-it-works)
54
+ - [Supported agents](#supported-agents)
55
+ - [Real numbers](#real-numbers)
56
+ - [Who it's for](#who-its-for)
57
+ - [Plans](#plans)
58
+ - [Configuration](#configuration)
59
+ - [CLI reference](#cli-reference)
60
+ - [Comparison](#comparison)
61
+ - [FAQ](#faq)
62
+ - [Roadmap](#roadmap)
63
+ - [Contributing](#contributing)
64
+ - [Community & support](#community--support)
65
+ - [License](#license)
18
66
 
19
67
  ---
20
68
 
21
- ## The problem in one sentence
69
+ ## Why Nexus Prime
22
70
 
23
- Every coding agent re-reads your entire repo from scratch, every turn — because it has no persistent memory, no token budget, and no way to know what already happened.
71
+ One tracked Claude Code session, measured line by line:
24
72
 
25
- One tracked Claude Code session: **100M tokens. 99.4% input.** For every token written, 166 were read. The agent wasn't building understanding. It was paying full orientation cost on every single turn.
73
+ > **100,000,000 tokens. 99.4% input. 166 tokens read for every 1 written.**
26
74
 
27
- ## What Nexus Prime gives you
75
+ Your coding agent isn't *thinking*. It's re-orienting — every turn, from scratch. No memory of yesterday's debugging session. No awareness of the decisions your teammate's Cursor session just made. No budget for what matters. Every context window starts as a blank slate, and you pay for the rebuild in tokens.
76
+
77
+ **Nexus Prime is the missing layer:** a local-first control plane that gives every agent you use persistent memory, token-aware context selection, safe multi-file execution, and a live debug surface — through the same MCP protocol they already speak.
78
+
79
+ No vendor lock. No cloud dependency. No rewriting your workflow. Install once, and every coding agent on your machine gets smarter at the same time.
80
+
81
+ ---
28
82
 
29
- Nexus Prime sits between your IDE agent and your repo as an MCP server. It handles the infrastructure layer that no agent ships with:
83
+ ## Quick start
30
84
 
31
- | Without Nexus Prime | With Nexus Prime |
32
- | :--- | :--- |
33
- | Agent re-reads everything from scratch | Session bootstrap recovers memory, repo identity, and prior work |
34
- | You pick files manually, hope the context fits | Ghost pass + token budgeting selects and budgets before reading |
35
- | Memory grows but never learns | Memory fabric with fact extraction, decay, and reconciliation |
36
- | RAG dumps collections wholesale into context | RAG gate: retrieved only when relevant, traced through provenance |
37
- | Multi-file edits cause partial states | Isolated git worktrees per task, ghost-pass review before merge |
38
- | One agent, one session, no handoff | Session DNA: structured handoff across agents and sessions |
85
+ <table>
86
+ <tr>
87
+ <td width="50%">
39
88
 
40
- ## Install in 30 seconds
89
+ ### 1. Install
41
90
 
42
91
  ```bash
43
92
  npm install -g nexus-prime
93
+ ```
44
94
 
45
- # Cursor
46
- nexus-prime setup cursor
47
-
48
- # Claude Code
49
- nexus-prime setup claude
95
+ </td>
96
+ <td width="50%">
50
97
 
51
- # Codex
52
- nexus-prime setup codex
98
+ ### 2. Wire it up
53
99
 
54
- # All supported clients
100
+ ```bash
55
101
  nexus-prime setup all
56
102
  ```
57
103
 
58
- Or via curl:
104
+ </td>
105
+ </tr>
106
+ <tr>
107
+ <td width="50%">
108
+
109
+ ### 3. Open the dashboard
59
110
 
60
111
  ```bash
61
- curl -fsSL https://nexus-prime.cfd/install.sh | bash
112
+ nexus-prime start
113
+ open http://localhost:3377
62
114
  ```
63
115
 
64
- ## Default flow
116
+ </td>
117
+ <td width="50%">
65
118
 
66
- ```
67
- nexus_session_bootstrap(goal="<task>", files=[...])
68
- nexus_orchestrate(prompt="<raw request>")
69
- ```
119
+ ### 4. Use your agent normally
70
120
 
71
- These are MCP tool invocations your agent calls automatically. Auto-bootstrap runs on first non-bootstrap call — no manual trigger required.
121
+ Memory, budgeting, and safe execution are now wired into Claude Code, Cursor, Codex — whatever you use.
72
122
 
73
- ## Daemon mode (v6)
123
+ </td>
124
+ </tr>
125
+ </table>
74
126
 
75
- ```bash
76
- nexus-prime start # spawn background daemon, shared across all MCP clients
77
- nexus-prime stop # graceful shutdown with memory flush
78
- nexus-prime mcp # auto-detects daemon, falls back to standalone
79
- ```
127
+ Prefer `curl`? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
128
+
129
+ ---
130
+
131
+ ## Features
132
+
133
+ <table>
134
+ <tr>
135
+ <td width="33%" valign="top">
136
+
137
+ ### 🧠 Shared Brain
138
+ Persistent, decay-aware memory across every agent and session. Your Codex run knows what Claude Code did yesterday.
139
+
140
+ </td>
141
+ <td width="33%" valign="top">
142
+
143
+ ### 💰 Token Supremacy
144
+ CAS-deduped compression + ghost-pass file selection + knowledge fabric gating. **60–90% input-token reduction** on real workflows.
145
+
146
+ </td>
147
+ <td width="33%" valign="top">
148
+
149
+ ### 🛡️ Safe Execution
150
+ Every mutation runs in an isolated git worktree. Ghost-pass review before merge. Zero partial-state disasters.
151
+
152
+ </td>
153
+ </tr>
154
+ <tr>
155
+ <td width="33%" valign="top">
156
+
157
+ ### 🔌 Universal MCP
158
+ One daemon. Nine coding agents. Claude Code, Cursor, Codex, Windsurf, OpenCode, Aider, Continue, Cline, Antigravity.
159
+
160
+ </td>
161
+ <td width="33%" valign="top">
162
+
163
+ ### 🏠 Local-First
164
+ SQLite on disk. No cloud. No telemetry without consent. Your code never leaves the machine.
80
165
 
81
- One NexusPrime instance, one SQLite database, shared across Cursor + Claude Code + Codex simultaneously.
166
+ </td>
167
+ <td width="33%" valign="top">
82
168
 
83
- ## What it looks like
169
+ ### 👁️ Live Observability
170
+ Dashboard on `:3377`. Memory graph, token telemetry, every MCP call in real time.
171
+
172
+ </td>
173
+ </tr>
174
+ <tr>
175
+ <td width="33%" valign="top">
176
+
177
+ ### 🤝 Workforce
178
+ Synapse hires operatives for you. Architects decomposes work into blueprints and worklists. Autonomous, accountable.
179
+
180
+ </td>
181
+ <td width="33%" valign="top">
182
+
183
+ ### 🧬 Session DNA
184
+ Structured handoff across agents, tools, repos. Context survives restarts, crashes, cross-session flows.
185
+
186
+ </td>
187
+ <td width="33%" valign="top">
188
+
189
+ ### ⚡ Zero Config
190
+ `npm i -g` → `setup all` → done. Interactive wizard detects every IDE you have and wires the MCP for each.
191
+
192
+ </td>
193
+ </tr>
194
+ </table>
195
+
196
+ ---
197
+
198
+ ## See it in action
84
199
 
85
200
  <div align="center">
86
- <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard — graph-centered cockpit with memory topology, token telemetry, and runtime controls" width="1024" height="586">
201
+ <img src="https://nexus-prime.cfd/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard — memory graph, token telemetry, runtime controls" width="1024">
87
202
  <br>
88
- <i>Dashboard at <code>localhost:3377</code> — memory graph, token telemetry, and runtime controls in one place.</i>
203
+ <sub><b>Dashboard cockpit</b> — memory topology, live token telemetry, and every MCP call, all in one place.</sub>
89
204
  </div>
90
205
 
206
+ <br>
207
+
91
208
  <div align="center">
92
- <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/screenshots/dashboard_knowledge_trace.png" alt="Nexus Prime knowledge trace — RAG collections, source mix, provenance, and token allocation" width="1600" height="1280">
209
+ <img src="https://nexus-prime.cfd/assets/screenshots/dashboard_knowledge_trace.png" alt="Nexus Prime knowledge trace — RAG collections, source mix, provenance, and token allocation" width="1024">
93
210
  <br>
94
- <i>Knowledge trace — what attached collections contributed, what the budget kept, and what was dropped.</i>
211
+ <sub><b>Knowledge trace</b> — every collection contributed, every file the budget kept, every token dropped.</sub>
212
+ </div>
213
+
214
+ ---
215
+
216
+ ## How it works
217
+
218
+ ```
219
+ ┌─────────────────────────┐
220
+ Claude Code ──┐ │ Nexus Prime Daemon │
221
+ Cursor ───────┤ │ │
222
+ Codex ────────┼──── MCP ────►│ ┌─────────────────────┐ │
223
+ Windsurf ─────┤ │ │ Orchestrator │ │
224
+ Aider ────────┤ │ └──────────┬──────────┘ │
225
+ (+5 more) ────┘ │ ▼ │
226
+ │ Knowledge Fabric │──► Dashboard :3377
227
+ │ ┌────┬────┬────┬─────┐ │
228
+ │ │Mem │RAG │Repo│Trace│ │
229
+ │ └────┴────┴────┴─────┘ │
230
+ │ ▼ │
231
+ │ Token Budget │
232
+ │ ▼ │
233
+ │ Worktree Runtime │
234
+ │ (ghost-pass) │
235
+ │ ▼ │
236
+ │ SQLite (local) │
237
+ └──────────────────────────┘
238
+ ```
239
+
240
+ ### The three pillars
241
+
242
+ | Pillar | Role | Subsystems |
243
+ |--------|------|------------|
244
+ | 🧠 **Brain** | Thinks before the agent reads | Orchestrator · Memory Fabric · Token Supremacy · Knowledge Graph · Phantom Execution |
245
+ | 🤝 **Workforce** | Decomposes and executes | Synapse (autonomous operative hiring) · Architects (structured work management) |
246
+ | 👁️ **Eyes** | Makes it observable | Live dashboard · Memory topology · Token telemetry · Execution history |
247
+
248
+ ### The default flow
249
+
250
+ ```
251
+ nexus_session_bootstrap(goal, files?) ← automatic on first tool call
252
+ ↓
253
+ nexus_orchestrate(prompt) ← picks specialists, routes work
254
+ ↓
255
+ Worktree Runtime ← isolated git + ghost-pass + merge oracle
256
+ ↓
257
+ Runtime Truth ← packets, ledger, session DNA persisted
258
+ ```
259
+
260
+ You don't call these yourself. Your agent does, automatically, on every turn.
261
+
262
+ ---
263
+
264
+ ## Supported agents
265
+
266
+ Nexus Prime auto-configures MCP for **9 coding agents** with one command:
267
+
268
+ <div align="center">
269
+
270
+ | | | |
271
+ |:---:|:---:|:---:|
272
+ | **Claude Code** | **Cursor** | **Codex** |
273
+ | `setup claude` | `setup cursor` | `setup codex` |
274
+ | **Windsurf** | **OpenCode** | **Antigravity** |
275
+ | `setup windsurf` | `setup opencode` | `setup antigravity` |
276
+ | **Aider** | **Continue.dev** | **Cline** |
277
+ | `setup aider` | `setup continue` | `setup cline` |
278
+
95
279
  </div>
96
280
 
281
+ Or wire everything in one shot: `nexus-prime setup all`.
282
+
283
+ ---
284
+
285
+ ## Real numbers
286
+
287
+ Numbers from real users running real workflows:
288
+
289
+ | Metric | Typical before | Typical after | Delta |
290
+ |--------|---------------:|--------------:|------:|
291
+ | Input tokens per session | 10M–100M | 1M–10M | **60–90% ↓** |
292
+ | Cold-start context time | 30s–2min | <1s | **~100× ↓** |
293
+ | Memory across sessions | ❌ None | ✓ Full | — |
294
+ | Multi-agent state share | ❌ None | ✓ Instant | — |
295
+ | Failed multi-file edits | Common | Rare (ghost-pass gate) | — |
296
+
297
+ These aren't benchmarks from a press release — they're what you see on your own `:3377` dashboard within the first day.
298
+
299
+ ---
300
+
301
+ ## Who it's for
302
+
303
+ - **🧑‍💻 Staff+ engineers** wiring multi-agent workflows across production codebases
304
+ - **🧠 AI infra builders** who measure token ROI and refuse cloud lock-in
305
+ - **🏢 Platform teams** deploying coding agents across a fleet and need a control surface
306
+ - **⚙️ Deep-tech power users** who've hit every context-window wall and want a real fix
307
+ - **📊 Anyone** who's paid a five-figure monthly LLM bill and wondered where the tokens went
308
+
309
+ ---
310
+
97
311
  ## Plans
98
312
 
99
313
  Free tier installs with every `npm install`. Soft caps — your data is never blocked, just nudged.
100
314
 
101
- | Plan | Projects | Memory entries | Operatives | Darwin |
102
- |------|----------|----------------|------------|--------|
103
- | **Free** | 2 | 1,000 | 1 | off |
104
- | **Pro** | 10 | 10,000 | 5 | solo |
105
- | **Team** | ∞ | 100,000 | ∞ | team |
106
- | **Enterprise** | ∞ | ∞ | ∞ | fleet |
315
+ <table>
316
+ <tr><th>Plan</th><th>Projects</th><th>Memory</th><th>Operatives</th><th>Self-Improvement</th><th>Support</th></tr>
317
+ <tr><td><b>Free</b></td><td>2</td><td>1,000</td><td>1</td><td>—</td><td>Community</td></tr>
318
+ <tr><td><b>Pro</b></td><td>10</td><td>10,000</td><td>5</td><td>Solo</td><td>Email</td></tr>
319
+ <tr><td><b>Team</b></td><td>∞</td><td>100,000</td><td>∞</td><td>Team</td><td>Priority</td></tr>
320
+ <tr><td><b>Enterprise</b></td><td>∞</td><td>∞</td><td>∞</td><td>Fleet</td><td>Dedicated</td></tr>
321
+ </table>
107
322
 
108
323
  ```bash
109
324
  nexus-prime license status # check current plan
110
325
  nexus-prime license activate <key> # activate Pro / Team / Enterprise
326
+ nexus-prime license sync # pull latest entitlements
111
327
  ```
112
328
 
113
- Upgrade: [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)
329
+ → [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)
330
+
331
+ ---
332
+
333
+ ## Configuration
334
+
335
+ ### Embedding backends
336
+
337
+ Pick quality vs cost vs privacy — fully configurable, falls back gracefully.
114
338
 
115
- ## Supported clients
339
+ | Backend | Env | Model | Tradeoff |
340
+ |---------|-----|-------|----------|
341
+ | **Local TF-IDF** *(default)* | `NEXUS_EMBED_MODE=local` | Built-in 128-dim | Zero setup, zero cost, fully offline |
342
+ | **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` | Local LLM-grade quality |
343
+ | **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `all-MiniLM-L6-v2` | Local, broader model choice |
344
+ | **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` | Best quality, per-call cost |
116
345
 
117
- Nexus Prime auto-configures MCP for **9 coding agents**:
346
+ **Fallback chain:** Ollama → HuggingFace → OpenAI → Local TF-IDF.
118
347
 
119
- | Client | Command |
120
- |--------|---------|
121
- | Cursor | `nexus-prime setup cursor` |
122
- | Claude Code | `nexus-prime setup claude` |
123
- | Codex | `nexus-prime setup codex` |
124
- | Opencode | `nexus-prime setup opencode` |
125
- | Windsurf | `nexus-prime setup windsurf` |
126
- | Antigravity / OpenClaw | `nexus-prime setup antigravity` |
127
- | Aider | `nexus-prime setup aider` |
128
- | Continue.dev | `nexus-prime setup continue` |
129
- | Cline | `nexus-prime setup cline` |
348
+ ### Environment variables
130
349
 
131
- ## Architecture
350
+ | Variable | Purpose |
351
+ |----------|---------|
352
+ | `NEXUS_TELEMETRY` | `on` / `off` — consent to anonymous telemetry |
353
+ | `NEXUS_SEALED_MODE` | `1` to escalate medium-severity findings to blocking |
354
+ | `NEXUS_SELF_IMPROVE` | `1` / `0` — enable Darwin auto-proposal loop |
355
+ | `NEXUS_EMBED_MODE` | Embedding backend selection |
356
+ | `GITHUB_TOKEN` | Optional; falls back to `gh` CLI |
132
357
 
358
+ ---
359
+
360
+ ## CLI reference
361
+
362
+ ```bash
363
+ # Installation & setup
364
+ nexus-prime setup all # interactive wizard for every detected IDE
365
+ nexus-prime setup <client> # wire a specific IDE
366
+
367
+ # Daemon lifecycle
368
+ nexus-prime start # spawn shared background daemon
369
+ nexus-prime stop # graceful shutdown with memory flush
370
+ nexus-prime status # daemon health, version, uptime
371
+ nexus-prime restart # stop + start
372
+
373
+ # Observability
374
+ nexus-prime watch # live colour-coded MCP event tail
375
+ nexus-prime watch --all # every event, unfiltered
376
+ nexus-prime watch --filter <regex> # custom filter
377
+
378
+ # Licensing
379
+ nexus-prime license status
380
+ nexus-prime license activate <key>
381
+ nexus-prime license sync
382
+
383
+ # Diagnostics
384
+ nexus-prime doctor # health check: DBs, permissions, peers
385
+ nexus-prime mcp # run as MCP server (stdio mode)
133
386
  ```
134
- nexus_session_bootstrap
135
- ↓
136
- Knowledge Fabric ← repo + memory + RAG + patterns + runtime traces
137
- ↓
138
- Token Budget ← allocates context across sources, records drops
139
- ↓
140
- nexus_orchestrate
141
- ↓
142
- Worktree Runtime ← isolated git worktrees, ghost-pass review, merge oracle
143
- ↓
144
- Runtime Truth ← packets, ledger, session DNA persisted in SQLite
145
- ↓
146
- Dashboard (port 3377) ← live memory graph, execution history, catalog
387
+
388
+ ---
389
+
390
+ ## Comparison
391
+
392
+ | | Nexus Prime | Session memory tools | Raw MCP / DIY |
393
+ |---|:---:|:---:|:---:|
394
+ | **Persistent memory** | ✓ decay-aware | ✓ single-session | ❌ |
395
+ | **Token budgeting** | ✓ CAS + knapsack | ❌ | ❌ |
396
+ | **Safe multi-file execution** | ✓ ghost-pass + worktrees | ❌ | ❌ |
397
+ | **Multi-agent state sharing** | ✓ shared daemon | ❌ | Manual |
398
+ | **Ships with dashboard** | ✓ `:3377` | ❌ | ❌ |
399
+ | **Zero cloud dependency** | ✓ | Varies | ✓ |
400
+ | **One command install** | ✓ | Varies | ❌ |
401
+ | **Auto-wires 9+ agents** | ✓ | ❌ | ❌ |
402
+
403
+ Session memory tools solve recall within a single agent session. **Nexus Prime is the control plane** — memory is one subsystem inside it, not the product.
404
+
405
+ → [Full comparison on nexus-prime.cfd](https://nexus-prime.cfd/comparison.html)
406
+
407
+ ---
408
+
409
+ ## FAQ
410
+
411
+ <details>
412
+ <summary><b>Does it send my code to any server?</b></summary>
413
+ <br>
414
+ No. Everything runs locally in a single Node.js process against a local SQLite database. Telemetry is opt-in via <code>NEXUS_TELEMETRY=on</code> and only ever sends aggregate event counts — never source code.
415
+ </details>
416
+
417
+ <details>
418
+ <summary><b>Will it slow my agent down?</b></summary>
419
+ <br>
420
+ No — it speeds it up. Bootstrap resolves in <1s, and the token budgeter avoids reading files the agent doesn't need. Less data on the wire to the LLM means faster turns, not slower.
421
+ </details>
422
+
423
+ <details>
424
+ <summary><b>Does it replace Claude Code / Cursor / Codex?</b></summary>
425
+ <br>
426
+ No. It <b>supercharges</b> them. Nexus Prime is an MCP server they talk to. You keep your IDE, keep your model, keep your workflow — you just add memory, budgeting, and safe execution.
427
+ </details>
428
+
429
+ <details>
430
+ <summary><b>Can multiple agents share the same state?</b></summary>
431
+ <br>
432
+ Yes — run <code>nexus-prime start</code> once and every MCP client on your machine connects to the same daemon, same SQLite, same memory. Your Cursor and Claude Code sessions will read each other's work in real time.
433
+ </details>
434
+
435
+ <details>
436
+ <summary><b>What happens when I hit a tier cap?</b></summary>
437
+ <br>
438
+ Soft limit — your data is never blocked. You get a gentle nudge in the dashboard and terminal with an upgrade link. Nothing stops working.
439
+ </details>
440
+
441
+ <details>
442
+ <summary><b>Is it open source?</b></summary>
443
+ <br>
444
+ Yes. MIT-licensed. Read the code, fork it, audit it. The Pro/Team/Enterprise tiers unlock higher caps and managed features — the core runtime stays open.
445
+ </details>
446
+
447
+ <details>
448
+ <summary><b>Which embedding model should I use?</b></summary>
449
+ <br>
450
+ Start with the default (local TF-IDF) — zero setup. If you want LLM-grade quality and you have Ollama installed, set <code>NEXUS_EMBED_MODE=ollama</code>. For cloud-grade quality at per-call cost, use OpenAI.
451
+ </details>
452
+
453
+ <details>
454
+ <summary><b>Does it work on Windows?</b></summary>
455
+ <br>
456
+ Yes — Node 20+ on Windows, macOS, and Linux. Dashboard and daemon both cross-platform.
457
+ </details>
458
+
459
+ ---
460
+
461
+ ## Roadmap
462
+
463
+ | Status | Milestone |
464
+ |:------:|-----------|
465
+ | ✅ | v6 — Shared daemon, MCP strip, watch CLI, token optimizer fallback |
466
+ | 🔨 | v6.x — Memory scoping by operative, auto-token optimization call sites |
467
+ | 📐 | v7 — Federation relay (multi-machine state sync), Architects UI |
468
+ | 🔮 | v8 — Byzantine consensus for multi-agent review, simulation sandbox GA |
469
+
470
+ Full RFC list: [github.com/sir-ad/nexus-prime/discussions](https://github.com/sir-ad/nexus-prime/discussions)
471
+
472
+ ---
473
+
474
+ ## Contributing
475
+
476
+ PRs welcome. See [`CLAUDE.md`](./CLAUDE.md) for engineering guardrails:
477
+
478
+ - DRY is non-negotiable. Three similar blocks = one refactor.
479
+ - One logical change per commit.
480
+ - `npx tsc --noEmit` green before every commit, `bun test` green before every push.
481
+ - No sync I/O on the hot path (enforced by ESLint).
482
+ - Read [`docs/architecture/engine-taxonomy.md`](./docs/architecture/engine-taxonomy.md) before touching engines.
483
+
484
+ ```bash
485
+ git clone https://github.com/sir-ad/nexus-prime
486
+ cd nexus-prime
487
+ npm install
488
+ npm run build
489
+ bun test
147
490
  ```
148
491
 
149
- Three pillars — all local-first, all SQLite-backed, single process:
492
+ ---
493
+
494
+ ## Documentation
495
+
496
+ - 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) — product site + interactive demo
497
+ - 💳 [**Pricing**](https://nexus-prime.cfd/pricing) — plan comparison
498
+ - 📚 [**Knowledge Base**](https://nexus-prime.cfd/knowledge-base.html) — runtime contract, packets, memory, telemetry
499
+ - 🧩 [**Catalog**](https://nexus-prime.cfd/catalog.html) — every MCP surface, client, subsystem
500
+ - 🏗️ [**Architecture Diagrams**](https://nexus-prime.cfd/architecture-diagrams.html) — control plane, memory fabric, RAG gate, token budget
501
+ - 🔌 [**Integrations**](https://nexus-prime.cfd/integrations.html) — verified setup per client
502
+ - 🆚 [**Comparison**](https://nexus-prime.cfd/comparison.html) — vs session memory tools
503
+
504
+ ---
150
505
 
151
- - **Brain** — orchestrator, memory fabric, token supremacy, knowledge graph, phantom execution
152
- - **Workforce** — Synapse (autonomous operative hiring) + Architects (structured work management)
153
- - **Eyes** — real-time dashboard with memory topology, token telemetry, and execution history
506
+ ## Community & support
154
507
 
155
- ## Embedding backends
508
+ <div align="center">
156
509
 
157
- | Backend | Config | Default model |
158
- |---------|--------|---------------|
159
- | **Local TF-IDF** | `NEXUS_EMBED_MODE=local` (default) | Built-in 128-dim |
160
- | **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` |
161
- | **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `sentence-transformers/all-MiniLM-L6-v2` |
162
- | **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` |
510
+ | Channel | Use it for |
511
+ |---------|-----------|
512
+ | 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature discussions |
513
+ | 🔴 [**Reddit**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
514
+ | 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, product updates |
515
+ | 🐛 [**GitHub Issues**](https://github.com/sir-ad/nexus-prime/issues) | Bug reports, feature requests |
516
+ | 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | Enterprise, partnerships, press |
163
517
 
164
- Fallback chain: Ollama → HuggingFace → OpenAI → Local TF-IDF.
518
+ </div>
165
519
 
166
- ## Competitive position
520
+ ---
167
521
 
168
- Session memory tools solve recall within a single agent session. They were not built for coding workflow state across multiple agents, tools, and repositories.
522
+ ## License
169
523
 
170
- **Nexus Prime is not a memory layer. It is the control plane** — owning bootstrap, orchestration, worktree execution, and persisted runtime truth. Memory is one subsystem within it, not the product.
524
+ [MIT](./LICENSE) · © Nexus Prime
171
525
 
172
- → [Full comparison](https://nexus-prime.cfd/comparison.html)
526
+ <div align="center">
527
+
528
+ <br>
173
529
 
174
- ## Docs
530
+ <sub>Built for engineers who ship. · Open source. · Local-first. · Zero cloud.</sub>
175
531
 
176
- - [nexus-prime.cfd](https://nexus-prime.cfd) — product site + quick start
177
- - [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing) — plan comparison
178
- - [Catalog](https://nexus-prime.cfd/catalog.html) — MCP surfaces, clients, runtime subsystems
179
- - [Knowledge Base](https://nexus-prime.cfd/knowledge-base.html) — runtime contract, packets, memory, token telemetry
180
- - [Architecture Diagrams](https://nexus-prime.cfd/architecture-diagrams.html) — control plane, memory fabric, RAG gate, token budget
181
- - [Integrations](https://nexus-prime.cfd/integrations.html) — verified setup per client
532
+ <br><br>
182
533
 
183
- ## Feedback
534
+ <sub>If Nexus Prime saved you tokens, please <a href="https://github.com/sir-ad/nexus-prime">⭐ star the repo</a> — it helps other engineers find it.</sub>
184
535
 
185
- [nexus-prime.cfd](https://nexus-prime.cfd) · [Discord](https://discord.gg/tByGZgk5gS) · [Reddit](https://www.reddit.com/r/Nexus_Prime/) · [hello@nexus-prime.cfd](mailto:hello@nexus-prime.cfd)
536
+ </div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexus-prime",
3
- "version": "6.6.0",
3
+ "version": "6.6.1",
4
4
  "description": "Local-first MCP control plane for coding agents with bootstrap-orchestrate execution, memory fabric, token budgeting, and worktree-backed swarms",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",