nexus-prime 6.6.1 → 6.6.2

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 +202 -277
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,31 +2,31 @@
2
2
  <img src="https://nexus-prime.cfd/assets/nexus-prime-logo.png" alt="Nexus Prime" width="120" height="120">
3
3
 
4
4
  <h1>Nexus Prime</h1>
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>
5
+ <p><strong>End agent amnesia.</strong></p>
6
+ <p><i>Your coding agents finally remember. Finally coordinate. Finally stop burning your token budget.</i></p>
7
7
 
8
8
  <p>
9
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
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
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>
12
+ <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
13
+ <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
14
14
  </p>
15
15
 
16
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">
17
+ <img src="https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge" alt="MCP Protocol">
18
+ <img src="https://img.shields.io/badge/license-Commercial-6f42c1?style=for-the-badge" alt="Commercial License">
19
+ <a href="https://nexus-prime.cfd/pricing"><img src="https://img.shields.io/badge/30--day-free%20trial-00ff88?style=for-the-badge" alt="30-day free trial"></a>
20
+ <img src="https://img.shields.io/badge/independent%20creators-free%20forever-ff69b4?style=for-the-badge" alt="Free for IC creators">
21
+ <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-444?style=for-the-badge" alt="Cross-platform">
22
22
  </p>
23
23
 
24
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">
25
+ <img src="https://img.shields.io/badge/AI%20coding%20agents-supported-8A2BE2?style=flat-square" alt="AI coding agents">
26
+ <img src="https://img.shields.io/badge/local--first-%E2%9C%93-00ff88?style=flat-square" alt="Local-first">
27
+ <img src="https://img.shields.io/badge/zero--cloud-%E2%9C%93-00ff88?style=flat-square" alt="Zero cloud">
28
+ <img src="https://img.shields.io/badge/no%20data%20leaves%20your%20machine-%E2%9C%93-00ff88?style=flat-square" alt="Privacy">
29
+ <img src="https://img.shields.io/badge/pilot%20program-open-ff9500?style=flat-square" alt="Pilot program">
30
30
  </p>
31
31
 
32
32
  <p>
@@ -38,45 +38,55 @@
38
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
39
  </div>
40
40
 
41
- > **Coding agents shipped without infrastructure. Nexus Prime is that infrastructure.**
41
+ > **Coding agents were never built to remember. Nexus Prime gives them a memory.**
42
42
  >
43
- > One SQLite brain. One daemon. Every agent you use. Zero cloud.
43
+ > Install once. Every coding agent on your machine gets smarter — together.
44
44
 
45
45
  ---
46
46
 
47
47
  ## Contents
48
48
 
49
- - [Why Nexus Prime](#why-nexus-prime)
49
+ - [The problem](#the-problem)
50
+ - [What changes when you install](#what-changes-when-you-install)
50
51
  - [Quick start](#quick-start)
51
52
  - [Features](#features)
52
53
  - [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)
54
+ - [Works with](#works-with)
55
+ - [What users see](#what-users-see)
56
56
  - [Who it's for](#who-its-for)
57
- - [Plans](#plans)
58
- - [Configuration](#configuration)
59
- - [CLI reference](#cli-reference)
60
- - [Comparison](#comparison)
57
+ - [Pricing](#pricing)
61
58
  - [FAQ](#faq)
62
- - [Roadmap](#roadmap)
63
- - [Contributing](#contributing)
59
+ - [Privacy](#privacy)
64
60
  - [Community & support](#community--support)
65
61
  - [License](#license)
66
62
 
67
63
  ---
68
64
 
69
- ## Why Nexus Prime
65
+ ## The problem
66
+
67
+ Every coding agent you use starts every session cold.
68
+
69
+ It has no idea what you worked on yesterday. It has no idea what your teammate's Cursor session just finished. It re-reads your repo from scratch, every single turn, for every single question — because that's the only thing it knows how to do.
70
70
 
71
- One tracked Claude Code session, measured line by line:
71
+ One tracked session was measured at **100,000,000 tokens**. Ninety-nine point four percent of them were input. **166 tokens read for every 1 written.** Your agent isn't thinking. It's re-orienting. And you're paying for that re-orientation over and over.
72
72
 
73
- > **100,000,000 tokens. 99.4% input. 166 tokens read for every 1 written.**
73
+ This is **agent amnesia** — and it's the quiet tax on every hour you spend with AI-assisted coding.
74
74
 
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.
75
+ **Nexus Prime ends it.**
76
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.
77
+ ---
78
+
79
+ ## What changes when you install
78
80
 
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.
81
+ | Before Nexus Prime | After Nexus Prime |
82
+ | :--- | :--- |
83
+ | Every session starts cold | Your agents pick up where they (or any other agent) left off |
84
+ | You pick files manually and pray they fit the context | Your agent reads only what matters — automatically |
85
+ | Memory grows but nothing learns | What was true yesterday is still true today |
86
+ | Multi-file edits sometimes leave the codebase in a half-broken state | Every change is reviewed and safe before it lands |
87
+ | Your Cursor and your Claude Code sessions are two strangers | They share the same memory, in real time |
88
+ | Token bills climb and you can't see why | A live dashboard shows exactly where every token went |
89
+ | Five-figure monthly LLM spend and no lever to pull | **Users typically cut input tokens by 60–90%** |
80
90
 
81
91
  ---
82
92
 
@@ -95,7 +105,7 @@ npm install -g nexus-prime
95
105
  </td>
96
106
  <td width="50%">
97
107
 
98
- ### 2. Wire it up
108
+ ### 2. Wire every agent you use
99
109
 
100
110
  ```bash
101
111
  nexus-prime setup all
@@ -110,21 +120,22 @@ nexus-prime setup all
110
120
 
111
121
  ```bash
112
122
  nexus-prime start
113
- open http://localhost:3377
114
123
  ```
115
124
 
125
+ Then visit `http://localhost:3377`.
126
+
116
127
  </td>
117
128
  <td width="50%">
118
129
 
119
- ### 4. Use your agent normally
130
+ ### 4. Use your agent like normal
120
131
 
121
- Memory, budgeting, and safe execution are now wired into Claude Code, Cursor, Codex — whatever you use.
132
+ That's it. Memory, budgeting, and safe execution are already on.
122
133
 
123
134
  </td>
124
135
  </tr>
125
136
  </table>
126
137
 
127
- Prefer `curl`? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
138
+ Prefer one-liner installs? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
128
139
 
129
140
  ---
130
141
 
@@ -134,60 +145,69 @@ Prefer `curl`? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
134
145
  <tr>
135
146
  <td width="33%" valign="top">
136
147
 
137
- ### 🧠 Shared Brain
138
- Persistent, decay-aware memory across every agent and session. Your Codex run knows what Claude Code did yesterday.
148
+ ### 🧠 Memory that sticks
149
+
150
+ Your agents remember what they did yesterday, last week, last sprint. Across every tool you use.
139
151
 
140
152
  </td>
141
153
  <td width="33%" valign="top">
142
154
 
143
- ### 💰 Token Supremacy
144
- CAS-deduped compression + ghost-pass file selection + knowledge fabric gating. **60–90% input-token reduction** on real workflows.
155
+ ### 💰 Bills that stop climbing
156
+
157
+ Your agent reads what matters — nothing else. Users typically see **60–90% fewer input tokens**.
145
158
 
146
159
  </td>
147
160
  <td width="33%" valign="top">
148
161
 
149
- ### 🛡️ Safe Execution
150
- Every mutation runs in an isolated git worktree. Ghost-pass review before merge. Zero partial-state disasters.
162
+ ### 🛡️ Safer coding sessions
163
+
164
+ Every multi-file edit is reviewed before it lands. No more half-broken commits because the agent got interrupted.
151
165
 
152
166
  </td>
153
167
  </tr>
154
168
  <tr>
155
169
  <td width="33%" valign="top">
156
170
 
157
- ### 🔌 Universal MCP
158
- One daemon. Nine coding agents. Claude Code, Cursor, Codex, Windsurf, OpenCode, Aider, Continue, Cline, Antigravity.
171
+ ### 🔌 Works with your stack
172
+
173
+ Claude Code, Cursor, Codex, Windsurf, OpenCode, Aider, Continue, Cline, Antigravity — all wired by one command.
159
174
 
160
175
  </td>
161
176
  <td width="33%" valign="top">
162
177
 
163
- ### 🏠 Local-First
164
- SQLite on disk. No cloud. No telemetry without consent. Your code never leaves the machine.
178
+ ### 🏠 Your code, your machine
179
+
180
+ Everything runs locally. No cloud. No telemetry without your consent. No vendor lock-in.
165
181
 
166
182
  </td>
167
183
  <td width="33%" valign="top">
168
184
 
169
- ### 👁️ Live Observability
170
- Dashboard on `:3377`. Memory graph, token telemetry, every MCP call in real time.
185
+ ### 👁️ A live dashboard
186
+
187
+ Watch memory form. Watch tokens drop. See every agent call in real time, at `localhost:3377`.
171
188
 
172
189
  </td>
173
190
  </tr>
174
191
  <tr>
175
192
  <td width="33%" valign="top">
176
193
 
177
- ### 🤝 Workforce
178
- Synapse hires operatives for you. Architects decomposes work into blueprints and worklists. Autonomous, accountable.
194
+ ### 🤝 Agents that coordinate
195
+
196
+ Your Cursor session and your Claude Code session share the same memory — simultaneously, without stepping on each other.
179
197
 
180
198
  </td>
181
199
  <td width="33%" valign="top">
182
200
 
183
- ### 🧬 Session DNA
184
- Structured handoff across agents, tools, repos. Context survives restarts, crashes, cross-session flows.
201
+ ### 🧬 Handoff across sessions
202
+
203
+ Close your laptop mid-task. Open it tomorrow. Any agent picks up exactly where the last one stopped.
185
204
 
186
205
  </td>
187
206
  <td width="33%" valign="top">
188
207
 
189
- ### ⚡ Zero Config
190
- `npm i -g` → `setup all` → done. Interactive wizard detects every IDE you have and wires the MCP for each.
208
+ ### ⚡ Zero config
209
+
210
+ Install, run `setup all`, done. The wizard detects every coding agent on your machine and wires each one.
191
211
 
192
212
  </td>
193
213
  </tr>
@@ -198,308 +218,206 @@ Structured handoff across agents, tools, repos. Context survives restarts, crash
198
218
  ## See it in action
199
219
 
200
220
  <div align="center">
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">
221
+ <img src="https://nexus-prime.cfd/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard — the memory graph and live activity your coding agent has been missing" width="1024">
202
222
  <br>
203
- <sub><b>Dashboard cockpit</b> — memory topology, live token telemetry, and every MCP call, all in one place.</sub>
223
+ <sub><b>The cockpit</b> — everything your agent is doing, everything it's remembered, everything it's saved you.</sub>
204
224
  </div>
205
225
 
206
226
  <br>
207
227
 
208
228
  <div align="center">
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">
229
+ <img src="https://nexus-prime.cfd/assets/screenshots/dashboard_knowledge_trace.png" alt="Nexus Prime knowledge trace — why the agent chose what it read" width="1024">
210
230
  <br>
211
- <sub><b>Knowledge trace</b> — every collection contributed, every file the budget kept, every token dropped.</sub>
231
+ <sub><b>The receipts</b> — every decision is traced, so you can see <i>why</i> your agent did what it did.</sub>
212
232
  </div>
213
233
 
214
234
  ---
215
235
 
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 |
236
+ ## Works with
247
237
 
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:
238
+ Nexus Prime wires up every major coding agent with one command:
267
239
 
268
240
  <div align="center">
269
241
 
270
242
  | | | |
271
243
  |:---:|:---:|:---:|
272
244
  | **Claude Code** | **Cursor** | **Codex** |
273
- | `setup claude` | `setup cursor` | `setup codex` |
274
245
  | **Windsurf** | **OpenCode** | **Antigravity** |
275
- | `setup windsurf` | `setup opencode` | `setup antigravity` |
276
246
  | **Aider** | **Continue.dev** | **Cline** |
277
- | `setup aider` | `setup continue` | `setup cline` |
278
247
 
279
248
  </div>
280
249
 
281
- Or wire everything in one shot: `nexus-prime setup all`.
250
+ Pick one: `nexus-prime setup claude` · `setup cursor` · `setup codex` · `setup windsurf` · `setup opencode` · `setup antigravity` · `setup aider` · `setup continue` · `setup cline`
251
+
252
+ Or just wire everything: **`nexus-prime setup all`**
282
253
 
283
254
  ---
284
255
 
285
- ## Real numbers
256
+ ## What users see
286
257
 
287
- Numbers from real users running real workflows:
258
+ Numbers from real users running real workflows on their own machines:
288
259
 
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) | — |
260
+ | Metric | Typical before | Typical after | What it means |
261
+ |--------|---------------:|--------------:|:--------------|
262
+ | Input tokens per session | 10M – 100M | 1M – 10M | **60–90% lower bills** |
263
+ | Cold-start context time | 30s – 2 min | under a second | Agents feel instant |
264
+ | Memory across sessions | None | Full | Nothing gets forgotten |
265
+ | Multi-agent state sharing | None | Real-time | Your tools stop fighting each other |
266
+ | Half-broken multi-file edits | Common | Rare | Merge with confidence |
296
267
 
297
- These aren't benchmarks from a press release — they're what you see on your own `:3377` dashboard within the first day.
268
+ No benchmarks from a press release — this is what the dashboard shows you, on day one.
298
269
 
299
270
  ---
300
271
 
301
272
  ## Who it's for
302
273
 
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
-
311
- ## Plans
312
-
313
- Free tier installs with every `npm install`. Soft caps — your data is never blocked, just nudged.
274
+ Nexus Prime is for people who take AI-assisted coding seriously:
314
275
 
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>
276
+ - **Engineers** who ship with AI every day and want their agents to actually get better over time
277
+ - **Creators and indie hackers** burning through trial credits and wondering where the tokens went
278
+ - **Teams** running coding agents across multiple people, multiple tools, and multiple repos
279
+ - **Power users** who've hit every context-window wall and want a real fix
280
+ - **Anyone** who's paid a four- or five-figure monthly LLM bill and felt it
322
281
 
323
- ```bash
324
- nexus-prime license status # check current plan
325
- nexus-prime license activate <key> # activate Pro / Team / Enterprise
326
- nexus-prime license sync # pull latest entitlements
327
- ```
328
-
329
- → [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)
282
+ If any of that sounds like you — keep reading.
330
283
 
331
284
  ---
332
285
 
333
- ## Configuration
334
-
335
- ### Embedding backends
336
-
337
- Pick quality vs cost vs privacy — fully configurable, falls back gracefully.
338
-
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 |
345
-
346
- **Fallback chain:** Ollama → HuggingFace → OpenAI → Local TF-IDF.
286
+ ## Pricing
347
287
 
348
- ### Environment variables
288
+ <div align="center">
349
289
 
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 |
290
+ **Free for 30 days. No credit card. No feature gating.**
357
291
 
358
- ---
292
+ </div>
359
293
 
360
- ## CLI reference
294
+ <table>
295
+ <tr>
296
+ <th>Plan</th>
297
+ <th>Who it's for</th>
298
+ <th>Price</th>
299
+ <th>Caps</th>
300
+ </tr>
301
+ <tr>
302
+ <td><b>🎁 Free Trial</b></td>
303
+ <td>Everyone — try it risk-free</td>
304
+ <td>Free for 30 days</td>
305
+ <td>All Pro features</td>
306
+ </tr>
307
+ <tr>
308
+ <td><b>💎 Independent Creators</b></td>
309
+ <td>Indie builders, solo engineers, students, OSS maintainers</td>
310
+ <td><b>Free forever</b></td>
311
+ <td>Unlimited usage on personal projects</td>
312
+ </tr>
313
+ <tr>
314
+ <td><b>🚀 Pilot Program</b></td>
315
+ <td>First 10 companies onboarding Nexus Prime</td>
316
+ <td><b>Free pilot</b> — contact us</td>
317
+ <td>Full Team features, white-glove onboarding</td>
318
+ </tr>
319
+ <tr>
320
+ <td><b>⚡ Pro</b></td>
321
+ <td>Professional engineers</td>
322
+ <td>See pricing page</td>
323
+ <td>10 projects · 10k memory entries · solo self-improvement</td>
324
+ </tr>
325
+ <tr>
326
+ <td><b>🏢 Team</b></td>
327
+ <td>Engineering teams</td>
328
+ <td>See pricing page</td>
329
+ <td>Unlimited projects · 100k memory entries · team coordination</td>
330
+ </tr>
331
+ <tr>
332
+ <td><b>🛡️ Enterprise</b></td>
333
+ <td>Larger orgs, regulated industries</td>
334
+ <td>Contact us</td>
335
+ <td>Unlimited everything · fleet features · dedicated support</td>
336
+ </tr>
337
+ </table>
361
338
 
362
339
  ```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)
340
+ nexus-prime license status # check your plan
341
+ nexus-prime license activate <key> # activate any paid tier
386
342
  ```
387
343
 
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)
344
+ → **[nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)** · **[Apply to the pilot program](mailto:hello@nexus-prime.cfd?subject=Pilot%20Program)**
406
345
 
407
346
  ---
408
347
 
409
348
  ## FAQ
410
349
 
411
350
  <details>
412
- <summary><b>Does it send my code to any server?</b></summary>
351
+ <summary><b>Will my code ever leave my machine?</b></summary>
413
352
  <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.
353
+ No. Everything runs locally. There is no cloud sync, no remote processing, no code upload. Anonymous usage telemetry is opt-in — you turn it on if you want, off by default.
415
354
  </details>
416
355
 
417
356
  <details>
418
- <summary><b>Will it slow my agent down?</b></summary>
357
+ <summary><b>Does this replace Claude Code, Cursor, or my IDE?</b></summary>
419
358
  <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.
359
+ No — it supercharges them. Keep the agents you already love. Nexus Prime adds memory, token budgeting, and safe execution underneath. You don't change your workflow; your workflow just gets better.
421
360
  </details>
422
361
 
423
362
  <details>
424
- <summary><b>Does it replace Claude Code / Cursor / Codex?</b></summary>
363
+ <summary><b>What happens after the 30-day trial ends?</b></summary>
425
364
  <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.
365
+ You're never locked out. You can keep using a free tier, pick a paid plan, or — if you're an independent creator — apply for free-forever access. Your memory, data, and projects stay yours either way.
427
366
  </details>
428
367
 
429
368
  <details>
430
- <summary><b>Can multiple agents share the same state?</b></summary>
369
+ <summary><b>Is it free for indie developers and creators?</b></summary>
431
370
  <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.
371
+ Yes. If you build independently — solo founder, indie dev, content creator, student, OSS maintainer — you qualify for unlimited free usage. Just <a href="mailto:hello@nexus-prime.cfd?subject=Creator%20Program">email us</a> and we'll sort it.
433
372
  </details>
434
373
 
435
374
  <details>
436
- <summary><b>What happens when I hit a tier cap?</b></summary>
375
+ <summary><b>My team wants to try this across the whole engineering org. What's the pilot?</b></summary>
437
376
  <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.
377
+ We're taking <b>10 companies</b> into our pilot program — full Team features free, white-glove onboarding, direct access to the team building it. First come, first served. <a href="mailto:hello@nexus-prime.cfd?subject=Pilot%20Program">Reach out</a>.
439
378
  </details>
440
379
 
441
380
  <details>
442
- <summary><b>Is it open source?</b></summary>
381
+ <summary><b>Will it actually speed my agent up?</b></summary>
443
382
  <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.
383
+ Yes. Less irrelevant context on the wire means faster turns and sharper responses. You also pay less per turn. The dashboard at <code>localhost:3377</code> shows you the exact savings in real time.
445
384
  </details>
446
385
 
447
386
  <details>
448
- <summary><b>Which embedding model should I use?</b></summary>
387
+ <summary><b>Does it work on Windows?</b></summary>
449
388
  <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.
389
+ Yes — Windows, macOS, and Linux are all first-class. Node 20+ is the only requirement.
451
390
  </details>
452
391
 
453
392
  <details>
454
- <summary><b>Does it work on Windows?</b></summary>
393
+ <summary><b>Can multiple team members share state?</b></summary>
455
394
  <br>
456
- Yes — Node 20+ on Windows, macOS, and Linux. Dashboard and daemon both cross-platform.
395
+ Each engineer runs their own local instance — nothing is shared across machines by default. Team coordination features (shared memory, role-based access) are on the Team and Enterprise plans.
457
396
  </details>
458
397
 
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 |
398
+ <details>
399
+ <summary><b>What if I hit my plan's cap?</b></summary>
400
+ <br>
401
+ Nothing stops working. You get a gentle in-app nudge and a link to upgrade. Your data is never held hostage.
402
+ </details>
469
403
 
470
- Full RFC list: [github.com/sir-ad/nexus-prime/discussions](https://github.com/sir-ad/nexus-prime/discussions)
404
+ <details>
405
+ <summary><b>Can I uninstall cleanly if I change my mind?</b></summary>
406
+ <br>
407
+ Yes. <code>nexus-prime stop && npm uninstall -g nexus-prime</code> — that's it. Your original agent setups keep working exactly as before.
408
+ </details>
471
409
 
472
410
  ---
473
411
 
474
- ## Contributing
475
-
476
- PRs welcome. See [`CLAUDE.md`](./CLAUDE.md) for engineering guardrails:
412
+ ## Privacy
477
413
 
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.
414
+ Nexus Prime was designed privacy-first, because the code on your machine is yours:
483
415
 
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
490
- ```
491
-
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
416
+ - 🏠 **100% local.** All data lives on your disk, in your home directory.
417
+ - 🚫 **No cloud sync.** Your code, your memory, your logs — never uploaded.
418
+ - 🔐 **No required account.** You can run the free trial without signing up for anything.
419
+ - 📊 **Telemetry is opt-in.** Off by default. When on, only aggregate, anonymous event counts are sent — never source code, never memory contents.
420
+ - 🗑️ **Uninstall is clean.** Everything lives in one directory you can delete.
503
421
 
504
422
  ---
505
423
 
@@ -507,13 +425,13 @@ bun test
507
425
 
508
426
  <div align="center">
509
427
 
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 |
428
+ | Channel | What to use it for |
429
+ |---------|-------------------|
430
+ | 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature ideas |
431
+ | 🔴 [**Reddit — r/Nexus_Prime**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
432
+ | 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, tips, updates |
433
+ | 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | Pilot program, creator program, enterprise, press |
434
+ | 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) | Product site, demos, pricing, setup guides |
517
435
 
518
436
  </div>
519
437
 
@@ -521,16 +439,23 @@ bun test
521
439
 
522
440
  ## License
523
441
 
524
- [MIT](./LICENSE) · © Nexus Prime
442
+ Nexus Prime is a **commercial product** with generous free tiers:
443
+
444
+ - ✅ Free for 30 days, for everyone
445
+ - ✅ Free forever for independent creators
446
+ - ✅ Free pilot for the first 10 partner companies
447
+ - 💳 Paid plans for professional, team, and enterprise usage
448
+
449
+ Commercial use without a valid license is prohibited. See [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing) for current plans and terms.
525
450
 
526
451
  <div align="center">
527
452
 
528
453
  <br>
529
454
 
530
- <sub>Built for engineers who ship. · Open source. · Local-first. · Zero cloud.</sub>
455
+ <sub>Built for engineers who ship. · Local-first. · Privacy-first. · Cloud-free.</sub>
531
456
 
532
457
  <br><br>
533
458
 
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>
459
+ <sub>If Nexus Prime ends your agent's amnesia, tell another engineer. That's how good tools spread. 🧠</sub>
535
460
 
536
461
  </div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexus-prime",
3
- "version": "6.6.1",
3
+ "version": "6.6.2",
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",