nexus-prime 6.6.1 → 7.0.0

package/README.md

@@ -2,31 +2,31 @@
   <img src="https://nexus-prime.cfd/assets/nexus-prime-logo.png" alt="Nexus Prime" width="120" height="120">
 
   <h1>Nexus Prime</h1>
-  <p><strong>The control plane your coding agent has been missing.</strong></p>
-  <p><i>Bootstrap. Orchestrate. Verify. Learn — across every agent, every session, every repo.</i></p>
+  <p><strong>End agent amnesia.</strong></p>
+  <p><i>Your coding agents finally remember. Finally coordinate. Finally stop burning your token budget.</i></p>
 
   <p>
     <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>
     <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>
     <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>
-    <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>
-    <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>
+    <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
+    <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
   </p>
 
   <p>
-    <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
-    <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
-    <img src="https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge" alt="MCP">
-    <img src="https://img.shields.io/badge/local--first-SQLite-003B57?style=for-the-badge&logo=sqlite&logoColor=white" alt="SQLite">
-    <img src="https://img.shields.io/badge/zero--cloud-%E2%9C%93-00ff88?style=for-the-badge" alt="Zero Cloud">
+    <img src="https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge" alt="MCP Protocol">
+    <img src="https://img.shields.io/badge/license-Commercial-6f42c1?style=for-the-badge" alt="Commercial License">
+    <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>
+    <img src="https://img.shields.io/badge/independent%20creators-free%20forever-ff69b4?style=for-the-badge" alt="Free for IC creators">
+    <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-444?style=for-the-badge" alt="Cross-platform">
   </p>
 
   <p>
-    <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>
-    <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>
-    <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>
-    <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>
-    <img src="https://img.shields.io/badge/made%20with-%E2%9D%A4-red?style=flat-square" alt="Made with love">
+    <img src="https://img.shields.io/badge/AI%20coding%20agents-supported-8A2BE2?style=flat-square" alt="AI coding agents">
+    <img src="https://img.shields.io/badge/local--first-%E2%9C%93-00ff88?style=flat-square" alt="Local-first">
+    <img src="https://img.shields.io/badge/zero--cloud-%E2%9C%93-00ff88?style=flat-square" alt="Zero cloud">
+    <img src="https://img.shields.io/badge/no%20data%20leaves%20your%20machine-%E2%9C%93-00ff88?style=flat-square" alt="Privacy">
+    <img src="https://img.shields.io/badge/pilot%20program-open-ff9500?style=flat-square" alt="Pilot program">
   </p>
 
   <p>
@@ -38,45 +38,55 @@
   <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>
 </div>
 
-> **Coding agents shipped without infrastructure. Nexus Prime is that infrastructure.**
+> **Coding agents were never built to remember. Nexus Prime gives them a memory.**
 >
-> One SQLite brain. One daemon. Every agent you use. Zero cloud.
+> Install once. Every coding agent on your machine gets smarter — together.
 
 ---
 
 ## Contents
 
-- [Why Nexus Prime](#why-nexus-prime)
+- [The problem](#the-problem)
+- [What changes when you install](#what-changes-when-you-install)
 - [Quick start](#quick-start)
 - [Features](#features)
 - [See it in action](#see-it-in-action)
-- [How it works](#how-it-works)
-- [Supported agents](#supported-agents)
-- [Real numbers](#real-numbers)
+- [Works with](#works-with)
+- [What users see](#what-users-see)
 - [Who it's for](#who-its-for)
-- [Plans](#plans)
-- [Configuration](#configuration)
-- [CLI reference](#cli-reference)
-- [Comparison](#comparison)
+- [Pricing](#pricing)
 - [FAQ](#faq)
-- [Roadmap](#roadmap)
-- [Contributing](#contributing)
+- [Privacy](#privacy)
 - [Community & support](#community--support)
 - [License](#license)
 
 ---
 
-## Why Nexus Prime
+## The problem
+
+Every coding agent you use starts every session cold.
+
+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.
 
-One tracked Claude Code session, measured line by line:
+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.
 
-> **100,000,000 tokens. 99.4% input. 166 tokens read for every 1 written.**
+This is **agent amnesia** — and it's the quiet tax on every hour you spend with AI-assisted coding.
 
-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.
+**Nexus Prime ends it.**
 
-**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.
+---
+
+## What changes when you install
 
-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.
+| Before Nexus Prime | After Nexus Prime |
+| :--- | :--- |
+| Every session starts cold | Your agents pick up where they (or any other agent) left off |
+| You pick files manually and pray they fit the context | Your agent reads only what matters — automatically |
+| Memory grows but nothing learns | What was true yesterday is still true today |
+| Multi-file edits sometimes leave the codebase in a half-broken state | Every change is reviewed and safe before it lands |
+| Your Cursor and your Claude Code sessions are two strangers | They share the same memory, in real time |
+| Token bills climb and you can't see why | A live dashboard shows exactly where every token went |
+| Five-figure monthly LLM spend and no lever to pull | **Users typically cut input tokens by 60–90%** |
 
 ---
 
@@ -95,7 +105,7 @@ npm install -g nexus-prime
 </td>
 <td width="50%">
 
-### 2. Wire it up
+### 2. Wire every agent you use
 
 ```bash
 nexus-prime setup all
@@ -110,21 +120,24 @@ nexus-prime setup all
 
 ```bash
 nexus-prime start
-open http://localhost:3377
 ```
 
+Then visit `http://localhost:3377`.
+
 </td>
 <td width="50%">
 
-### 4. Use your agent normally
+### 4. Use your agent like normal
 
-Memory, budgeting, and safe execution are now wired into Claude Code, Cursor, Codex — whatever you use.
+That's it. Memory, budgeting, and safe execution are already on.
 
 </td>
 </tr>
 </table>
 
-Prefer `curl`? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
+Prefer one-liner installs? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
+
+Your agent calls `nexus_session_bootstrap` + `nexus_orchestrate` automatically. Auto-bootstrap runs on first non-bootstrap call, so you never have to wire the packet by hand.
 
 ---
 
@@ -134,60 +147,69 @@ Prefer `curl`? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`
 <tr>
 <td width="33%" valign="top">
 
-### 🧠 Shared Brain
-Persistent, decay-aware memory across every agent and session. Your Codex run knows what Claude Code did yesterday.
+### 🧠 Memory that sticks
+
+Your agents remember what they did yesterday, last week, last sprint. Across every tool you use.
 
 </td>
 <td width="33%" valign="top">
 
-### 💰 Token Supremacy
-CAS-deduped compression + ghost-pass file selection + knowledge fabric gating. **60–90% input-token reduction** on real workflows.
+### 💰 Bills that stop climbing
+
+Your agent reads what matters — nothing else. Users typically see **60–90% fewer input tokens**.
 
 </td>
 <td width="33%" valign="top">
 
-### 🛡️ Safe Execution
-Every mutation runs in an isolated git worktree. Ghost-pass review before merge. Zero partial-state disasters.
+### 🛡️ Safer coding sessions
+
+Every multi-file edit is reviewed before it lands. No more half-broken commits because the agent got interrupted.
 
 </td>
 </tr>
 <tr>
 <td width="33%" valign="top">
 
-### 🔌 Universal MCP
-One daemon. Nine coding agents. Claude Code, Cursor, Codex, Windsurf, OpenCode, Aider, Continue, Cline, Antigravity.
+### 🔌 Works with your stack
+
+Claude Code, Cursor, Codex, Windsurf, OpenCode, Aider, Continue, Cline, Antigravity — all wired by one command.
 
 </td>
 <td width="33%" valign="top">
 
-### 🏠 Local-First
-SQLite on disk. No cloud. No telemetry without consent. Your code never leaves the machine.
+### 🏠 Your code, your machine
+
+Everything runs locally. No cloud. No telemetry without your consent. No vendor lock-in.
 
 </td>
 <td width="33%" valign="top">
 
-### 👁️ Live Observability
-Dashboard on `:3377`. Memory graph, token telemetry, every MCP call in real time.
+### 👁️ A live dashboard
+
+Watch memory form. Watch tokens drop. See every agent call in real time, at `localhost:3377`.
 
 </td>
 </tr>
 <tr>
 <td width="33%" valign="top">
 
-### 🤝 Workforce
-Synapse hires operatives for you. Architects decomposes work into blueprints and worklists. Autonomous, accountable.
+### 🤝 Agents that coordinate
+
+Your Cursor session and your Claude Code session share the same memory — simultaneously, without stepping on each other.
 
 </td>
 <td width="33%" valign="top">
 
-### 🧬 Session DNA
-Structured handoff across agents, tools, repos. Context survives restarts, crashes, cross-session flows.
+### 🧬 Handoff across sessions
+
+Close your laptop mid-task. Open it tomorrow. Any agent picks up exactly where the last one stopped.
 
 </td>
 <td width="33%" valign="top">
 
-### ⚡ Zero Config
-`npm i -g` → `setup all` → done. Interactive wizard detects every IDE you have and wires the MCP for each.
+### ⚡ Zero config
+
+Install, run `setup all`, done. The wizard detects every coding agent on your machine and wires each one.
 
 </td>
 </tr>
@@ -198,308 +220,212 @@ Structured handoff across agents, tools, repos. Context survives restarts, crash
 ## See it in action
 
 <div align="center">
-  <img src="https://nexus-prime.cfd/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard — memory graph, token telemetry, runtime controls" width="1024">
+  <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">
   <br>
-  <sub><b>Dashboard cockpit</b> — memory topology, live token telemetry, and every MCP call, all in one place.</sub>
+  <sub><b>The cockpit</b> — everything your agent is doing, everything it's remembered, everything it's saved you.</sub>
 </div>
 
 <br>
 
 <div align="center">
-  <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">
+  <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">
   <br>
-  <sub><b>Knowledge trace</b> — every collection contributed, every file the budget kept, every token dropped.</sub>
+  <sub><b>The receipts</b> — every decision is traced, so you can see <i>why</i> your agent did what it did.</sub>
 </div>
 
 ---
 
-## How it works
-
-```
-                              ┌─────────────────────────┐
- Claude Code ──┐              │   Nexus Prime Daemon     │
- Cursor ───────┤              │                          │
- Codex ────────┼──── MCP ────►│  ┌─────────────────────┐ │
- Windsurf ─────┤              │  │   Orchestrator      │ │
- Aider ────────┤              │  └──────────┬──────────┘ │
- (+5 more) ────┘              │             ▼            │
-                              │   Knowledge Fabric       │──► Dashboard :3377
-                              │  ┌────┬────┬────┬─────┐  │
-                              │  │Mem │RAG │Repo│Trace│  │
-                              │  └────┴────┴────┴─────┘  │
-                              │             ▼            │
-                              │     Token Budget         │
-                              │             ▼            │
-                              │   Worktree Runtime       │
-                              │     (ghost-pass)         │
-                              │             ▼            │
-                              │      SQLite (local)      │
-                              └──────────────────────────┘
-```
-
-### The three pillars
+## Works with
 
-| Pillar | Role | Subsystems |
-|--------|------|------------|
-| 🧠 **Brain** | Thinks before the agent reads | Orchestrator · Memory Fabric · Token Supremacy · Knowledge Graph · Phantom Execution |
-| 🤝 **Workforce** | Decomposes and executes | Synapse (autonomous operative hiring) · Architects (structured work management) |
-| 👁️ **Eyes** | Makes it observable | Live dashboard · Memory topology · Token telemetry · Execution history |
-
-### The default flow
-
-```
-nexus_session_bootstrap(goal, files?)   ← automatic on first tool call
-         ↓
-nexus_orchestrate(prompt)               ← picks specialists, routes work
-         ↓
-Worktree Runtime                        ← isolated git + ghost-pass + merge oracle
-         ↓
-Runtime Truth                           ← packets, ledger, session DNA persisted
-```
-
-You don't call these yourself. Your agent does, automatically, on every turn.
-
----
-
-## Supported agents
-
-Nexus Prime auto-configures MCP for **9 coding agents** with one command:
+Nexus Prime wires up every major coding agent with one command:
 
 <div align="center">
 
 | | | |
 |:---:|:---:|:---:|
 | **Claude Code** | **Cursor** | **Codex** |
-| `setup claude` | `setup cursor` | `setup codex` |
 | **Windsurf** | **OpenCode** | **Antigravity** |
-| `setup windsurf` | `setup opencode` | `setup antigravity` |
 | **Aider** | **Continue.dev** | **Cline** |
-| `setup aider` | `setup continue` | `setup cline` |
 
 </div>
 
-Or wire everything in one shot: `nexus-prime setup all`.
-
----
-
-## Real numbers
-
-Numbers from real users running real workflows:
-
-| Metric | Typical before | Typical after | Delta |
-|--------|---------------:|--------------:|------:|
-| Input tokens per session | 10M–100M | 1M–10M | **60–90% ↓** |
-| Cold-start context time | 30s–2min | <1s | **~100× ↓** |
-| Memory across sessions | ❌ None | ✓ Full | — |
-| Multi-agent state share | ❌ None | ✓ Instant | — |
-| Failed multi-file edits | Common | Rare (ghost-pass gate) | — |
+Pick one: `nexus-prime setup claude` · `setup cursor` · `setup codex` · `setup windsurf` · `setup opencode` · `setup antigravity` · `setup aider` · `setup continue` · `setup cline`
 
-These aren't benchmarks from a press release — they're what you see on your own `:3377` dashboard within the first day.
+Or just wire everything: **`nexus-prime setup all`**
 
 ---
 
-## Who it's for
+## Competitive position
 
-- **🧑‍💻 Staff+ engineers** wiring multi-agent workflows across production codebases
-- **🧠 AI infra builders** who measure token ROI and refuse cloud lock-in
-- **🏢 Platform teams** deploying coding agents across a fleet and need a control surface
-- **⚙️ Deep-tech power users** who've hit every context-window wall and want a real fix
-- **📊 Anyone** who's paid a five-figure monthly LLM bill and wondered where the tokens went
+Nexus Prime is the only control plane that remembers the repo, budgets the tokens, and ghost-passes every mutation — locally, in one process. Compare head-to-head on [nexus-prime.cfd/comparison.html](https://nexus-prime.cfd/comparison.html) or read the full docs on [nexus-prime.cfd/knowledge-base.html](https://nexus-prime.cfd/knowledge-base.html).
 
 ---
 
-## Plans
+## What users see
 
-Free tier installs with every `npm install`. Soft caps — your data is never blocked, just nudged.
+Numbers from real users running real workflows on their own machines:
 
-<table>
-<tr><th>Plan</th><th>Projects</th><th>Memory</th><th>Operatives</th><th>Self-Improvement</th><th>Support</th></tr>
-<tr><td><b>Free</b></td><td>2</td><td>1,000</td><td>1</td><td>—</td><td>Community</td></tr>
-<tr><td><b>Pro</b></td><td>10</td><td>10,000</td><td>5</td><td>Solo</td><td>Email</td></tr>
-<tr><td><b>Team</b></td><td>∞</td><td>100,000</td><td>∞</td><td>Team</td><td>Priority</td></tr>
-<tr><td><b>Enterprise</b></td><td>∞</td><td>∞</td><td>∞</td><td>Fleet</td><td>Dedicated</td></tr>
-</table>
+| Metric | Typical before | Typical after | What it means |
+|--------|---------------:|--------------:|:--------------|
+| Input tokens per session | 10M – 100M | 1M – 10M | **60–90% lower bills** |
+| Cold-start context time | 30s – 2 min | under a second | Agents feel instant |
+| Memory across sessions | None | Full | Nothing gets forgotten |
+| Multi-agent state sharing | None | Real-time | Your tools stop fighting each other |
+| Half-broken multi-file edits | Common | Rare | Merge with confidence |
 
-```bash
-nexus-prime license status          # check current plan
-nexus-prime license activate <key>  # activate Pro / Team / Enterprise
-nexus-prime license sync            # pull latest entitlements
-```
-
-→ [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)
+No benchmarks from a press release — this is what the dashboard shows you, on day one.
 
 ---
 
-## Configuration
-
-### Embedding backends
-
-Pick quality vs cost vs privacy — fully configurable, falls back gracefully.
-
-| Backend | Env | Model | Tradeoff |
-|---------|-----|-------|----------|
-| **Local TF-IDF** *(default)* | `NEXUS_EMBED_MODE=local` | Built-in 128-dim | Zero setup, zero cost, fully offline |
-| **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` | Local LLM-grade quality |
-| **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `all-MiniLM-L6-v2` | Local, broader model choice |
-| **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` | Best quality, per-call cost |
+## Who it's for
 
-**Fallback chain:** Ollama → HuggingFace → OpenAI → Local TF-IDF.
+Nexus Prime is for people who take AI-assisted coding seriously:
 
-### Environment variables
+- **Engineers** who ship with AI every day and want their agents to actually get better over time
+- **Creators and indie hackers** burning through trial credits and wondering where the tokens went
+- **Teams** running coding agents across multiple people, multiple tools, and multiple repos
+- **Power users** who've hit every context-window wall and want a real fix
+- **Anyone** who's paid a four- or five-figure monthly LLM bill and felt it
 
-| Variable | Purpose |
-|----------|---------|
-| `NEXUS_TELEMETRY` | `on` / `off` — consent to anonymous telemetry |
-| `NEXUS_SEALED_MODE` | `1` to escalate medium-severity findings to blocking |
-| `NEXUS_SELF_IMPROVE` | `1` / `0` — enable Darwin auto-proposal loop |
-| `NEXUS_EMBED_MODE` | Embedding backend selection |
-| `GITHUB_TOKEN` | Optional; falls back to `gh` CLI |
+If any of that sounds like you — keep reading.
 
 ---
 
-## CLI reference
+## Pricing
 
-```bash
-# Installation & setup
-nexus-prime setup all                 # interactive wizard for every detected IDE
-nexus-prime setup <client>            # wire a specific IDE
-
-# Daemon lifecycle
-nexus-prime start                     # spawn shared background daemon
-nexus-prime stop                      # graceful shutdown with memory flush
-nexus-prime status                    # daemon health, version, uptime
-nexus-prime restart                   # stop + start
-
-# Observability
-nexus-prime watch                     # live colour-coded MCP event tail
-nexus-prime watch --all               # every event, unfiltered
-nexus-prime watch --filter <regex>    # custom filter
-
-# Licensing
-nexus-prime license status
-nexus-prime license activate <key>
-nexus-prime license sync
-
-# Diagnostics
-nexus-prime doctor                    # health check: DBs, permissions, peers
-nexus-prime mcp                       # run as MCP server (stdio mode)
-```
+<div align="center">
 
----
+**Free for 30 days. No credit card. No feature gating.**
 
-## Comparison
+</div>
 
-| | Nexus Prime | Session memory tools | Raw MCP / DIY |
-|---|:---:|:---:|:---:|
-| **Persistent memory** | ✓ decay-aware | ✓ single-session | ❌ |
-| **Token budgeting** | ✓ CAS + knapsack | ❌ | ❌ |
-| **Safe multi-file execution** | ✓ ghost-pass + worktrees | ❌ | ❌ |
-| **Multi-agent state sharing** | ✓ shared daemon | ❌ | Manual |
-| **Ships with dashboard** | ✓ `:3377` | ❌ | ❌ |
-| **Zero cloud dependency** | ✓ | Varies | ✓ |
-| **One command install** | ✓ | Varies | ❌ |
-| **Auto-wires 9+ agents** | ✓ | ❌ | ❌ |
+<table>
+<tr>
+  <th>Plan</th>
+  <th>Who it's for</th>
+  <th>Price</th>
+  <th>Caps</th>
+</tr>
+<tr>
+  <td><b>🎁 Free Trial</b></td>
+  <td>Everyone — try it risk-free</td>
+  <td>Free for 30 days</td>
+  <td>All Pro features</td>
+</tr>
+<tr>
+  <td><b>💎 Independent Creators</b></td>
+  <td>Indie builders, solo engineers, students, OSS maintainers</td>
+  <td><b>Free forever</b></td>
+  <td>Unlimited usage on personal projects</td>
+</tr>
+<tr>
+  <td><b>🚀 Pilot Program</b></td>
+  <td>First 10 companies onboarding Nexus Prime</td>
+  <td><b>Free pilot</b> — contact us</td>
+  <td>Full Team features, white-glove onboarding</td>
+</tr>
+<tr>
+  <td><b>⚡ Pro</b></td>
+  <td>Professional engineers</td>
+  <td>See pricing page</td>
+  <td>10 projects · 10k memory entries · solo self-improvement</td>
+</tr>
+<tr>
+  <td><b>🏢 Team</b></td>
+  <td>Engineering teams</td>
+  <td>See pricing page</td>
+  <td>Unlimited projects · 100k memory entries · team coordination</td>
+</tr>
+<tr>
+  <td><b>🛡️ Enterprise</b></td>
+  <td>Larger orgs, regulated industries</td>
+  <td>Contact us</td>
+  <td>Unlimited everything · fleet features · dedicated support</td>
+</tr>
+</table>
 
-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.
+```bash
+nexus-prime license status          # check your plan
+nexus-prime license activate <key>  # activate any paid tier
+```
 
-→ [Full comparison on nexus-prime.cfd](https://nexus-prime.cfd/comparison.html)
+→ **[nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)** · **[Apply to the pilot program](mailto:hello@nexus-prime.cfd?subject=Pilot%20Program)**
 
 ---
 
 ## FAQ
 
 <details>
-<summary><b>Does it send my code to any server?</b></summary>
+<summary><b>Will my code ever leave my machine?</b></summary>
 <br>
-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.
+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.
 </details>
 
 <details>
-<summary><b>Will it slow my agent down?</b></summary>
+<summary><b>Does this replace Claude Code, Cursor, or my IDE?</b></summary>
 <br>
-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.
+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.
 </details>
 
 <details>
-<summary><b>Does it replace Claude Code / Cursor / Codex?</b></summary>
+<summary><b>What happens after the 30-day trial ends?</b></summary>
 <br>
-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.
+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.
 </details>
 
 <details>
-<summary><b>Can multiple agents share the same state?</b></summary>
+<summary><b>Is it free for indie developers and creators?</b></summary>
 <br>
-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.
+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.
 </details>
 
 <details>
-<summary><b>What happens when I hit a tier cap?</b></summary>
+<summary><b>My team wants to try this across the whole engineering org. What's the pilot?</b></summary>
 <br>
-Soft limit — your data is never blocked. You get a gentle nudge in the dashboard and terminal with an upgrade link. Nothing stops working.
+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>.
 </details>
 
 <details>
-<summary><b>Is it open source?</b></summary>
+<summary><b>Will it actually speed my agent up?</b></summary>
 <br>
-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.
+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.
 </details>
 
 <details>
-<summary><b>Which embedding model should I use?</b></summary>
+<summary><b>Does it work on Windows?</b></summary>
 <br>
-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.
+Yes — Windows, macOS, and Linux are all first-class. Node 20+ is the only requirement.
 </details>
 
 <details>
-<summary><b>Does it work on Windows?</b></summary>
+<summary><b>Can multiple team members share state?</b></summary>
 <br>
-Yes — Node 20+ on Windows, macOS, and Linux. Dashboard and daemon both cross-platform.
+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.
 </details>
 
----
-
-## Roadmap
-
-| Status | Milestone |
-|:------:|-----------|
-| ✅ | v6 — Shared daemon, MCP strip, watch CLI, token optimizer fallback |
-| 🔨 | v6.x — Memory scoping by operative, auto-token optimization call sites |
-| 📐 | v7 — Federation relay (multi-machine state sync), Architects UI |
-| 🔮 | v8 — Byzantine consensus for multi-agent review, simulation sandbox GA |
+<details>
+<summary><b>What if I hit my plan's cap?</b></summary>
+<br>
+Nothing stops working. You get a gentle in-app nudge and a link to upgrade. Your data is never held hostage.
+</details>
 
-Full RFC list: [github.com/sir-ad/nexus-prime/discussions](https://github.com/sir-ad/nexus-prime/discussions)
+<details>
+<summary><b>Can I uninstall cleanly if I change my mind?</b></summary>
+<br>
+Yes. <code>nexus-prime stop && npm uninstall -g nexus-prime</code> — that's it. Your original agent setups keep working exactly as before.
+</details>
 
 ---
 
-## Contributing
-
-PRs welcome. See [`CLAUDE.md`](./CLAUDE.md) for engineering guardrails:
+## Privacy
 
-- DRY is non-negotiable. Three similar blocks = one refactor.
-- One logical change per commit.
-- `npx tsc --noEmit` green before every commit, `bun test` green before every push.
-- No sync I/O on the hot path (enforced by ESLint).
-- Read [`docs/architecture/engine-taxonomy.md`](./docs/architecture/engine-taxonomy.md) before touching engines.
+Nexus Prime was designed privacy-first, because the code on your machine is yours:
 
-```bash
-git clone https://github.com/sir-ad/nexus-prime
-cd nexus-prime
-npm install
-npm run build
-bun test
-```
-
----
-
-## Documentation
-
-- 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) — product site + interactive demo
-- 💳 [**Pricing**](https://nexus-prime.cfd/pricing) — plan comparison
-- 📚 [**Knowledge Base**](https://nexus-prime.cfd/knowledge-base.html) — runtime contract, packets, memory, telemetry
-- 🧩 [**Catalog**](https://nexus-prime.cfd/catalog.html) — every MCP surface, client, subsystem
-- 🏗️ [**Architecture Diagrams**](https://nexus-prime.cfd/architecture-diagrams.html) — control plane, memory fabric, RAG gate, token budget
-- 🔌 [**Integrations**](https://nexus-prime.cfd/integrations.html) — verified setup per client
-- 🆚 [**Comparison**](https://nexus-prime.cfd/comparison.html) — vs session memory tools
+- 🏠 **100% local.** All data lives on your disk, in your home directory.
+- 🚫 **No cloud sync.** Your code, your memory, your logs — never uploaded.
+- 🔐 **No required account.** You can run the free trial without signing up for anything.
+- 📊 **Telemetry is opt-in.** Off by default. When on, only aggregate, anonymous event counts are sent — never source code, never memory contents.
+- 🗑️ **Uninstall is clean.** Everything lives in one directory you can delete.
 
 ---
 
@@ -507,13 +433,13 @@ bun test
 
 <div align="center">
 
-| Channel | Use it for |
-|---------|-----------|
-| 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature discussions |
-| 🔴 [**Reddit**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
-| 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, product updates |
-| 🐛 [**GitHub Issues**](https://github.com/sir-ad/nexus-prime/issues) | Bug reports, feature requests |
-| 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | Enterprise, partnerships, press |
+| Channel | What to use it for |
+|---------|-------------------|
+| 💬 [**Discord**](https://discord.gg/tByGZgk5gS) | Real-time help, show-and-tell, feature ideas |
+| 🔴 [**Reddit — r/Nexus_Prime**](https://www.reddit.com/r/Nexus_Prime/) | Long-form posts, releases, community wins |
+| 🐦 [**X / Twitter**](https://x.com/nexusprime_ai) | Launch announcements, tips, updates |
+| 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | Pilot program, creator program, enterprise, press |
+| 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) | Product site, demos, pricing, setup guides |
 
 </div>
 
@@ -521,16 +447,23 @@ bun test
 
 ## License
 
-[MIT](./LICENSE) · © Nexus Prime
+Nexus Prime is a **commercial product** with generous free tiers:
+
+- ✅ Free for 30 days, for everyone
+- ✅ Free forever for independent creators
+- ✅ Free pilot for the first 10 partner companies
+- 💳 Paid plans for professional, team, and enterprise usage
+
+Commercial use without a valid license is prohibited. See [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing) for current plans and terms.
 
 <div align="center">
 
 <br>
 
-<sub>Built for engineers who ship. · Open source. · Local-first. · Zero cloud.</sub>
+<sub>Built for engineers who ship. · Local-first. · Privacy-first. · Cloud-free.</sub>
 
 <br><br>
 
-<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>
+<sub>If Nexus Prime ends your agent's amnesia, tell another engineer. That's how good tools spread. 🧠</sub>
 
 </div>