<div align="center">
  <img src="https://nexus-prime.cfd/assets/nexus-prime-logo.png" alt="Nexus Prime" width="120" height="120">

  <h1>Nexus Prime</h1>
  <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>
    <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/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/3--day-grace%20then%20license-00ff88?style=for-the-badge" alt="3-day grace then license"></a>
    <img src="https://img.shields.io/badge/licenses-reviewed%20within%2024h-ff69b4?style=for-the-badge" alt="Licenses reviewed within 24 hours">
    <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>
    <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>
    <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>
    <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>
    <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>
  </p>

  <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>

> **Stop restarting your coding agents from zero.**
>
> Nexus Prime gives Claude Code, Codex, Cursor, Windsurf, OpenCode, Aider, and the rest of your local agent stack one shared memory, one proof trail, and one dashboard for what actually happened.

---

## Contents

- [The problem](#the-problem)
- [What changes when you install](#what-changes-when-you-install)
- [Quick start](#quick-start)
- [Docs and comparison](#docs-and-comparison)
- [Features](#features)
- [See it in action](#see-it-in-action)
- [Competitive position](#competitive-position)
- [Works with](#works-with)
- [What users see](#what-users-see)
- [Who it's for](#who-its-for)
- [Pricing](#pricing)
- [FAQ](#faq)
- [Privacy](#privacy)
- [Community & support](#community--support)
- [License](#license)

---

## Docs and comparison

- Website: https://nexus-prime.cfd/
- Comparison: https://nexus-prime.cfd/comparison.html
- Knowledge base: https://nexus-prime.cfd/knowledge-base.html

Agents should start with `nexus_session_bootstrap`, then route the raw request through `nexus_orchestrate`. Auto-bootstrap runs on first non-bootstrap call for compatible clients, but the explicit bootstrap-first path remains the safest integration contract.

---

## Why teams install it

Nexus Prime is the local-first control plane for serious AI-assisted coding.

- **Shared memory for every agent.** Your tools stop acting like strangers and start carrying useful context across sessions.
- **Lower token waste.** Nexus routes agents toward the files and facts that matter instead of rereading the repo every turn.
- **Runtime truth you can inspect.** The dashboard shows runs, memory, token savings, and agent activity instead of hiding the messy parts.
- **Safer multi-file work.** Planning, verification, and handoff state stay attached to the repo, so interrupted work is easier to resume and review.
- **Local by default.** Your code and agent memory stay on your machine unless you explicitly opt into something else.

---

## 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 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.

This is **agent amnesia** — and it's the quiet tax on every hour you spend with AI-assisted coding.

**Nexus Prime turns that cold start into a remembered workspace.**

---

## What changes when you install

| 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%** |

---

## Quick start

<table>
<tr>
<td width="50%">

### 1. Install

```bash
npm install -g nexus-prime
```

</td>
<td width="50%">

### 2. Wire every agent you use

```bash
nexus-prime setup all
```

</td>
</tr>
<tr>
<td width="50%">

### 3. Open the dashboard

```bash
nexus-prime start
```

Then visit `http://localhost:3377`.

</td>
<td width="50%">

### 4. Use your agent like normal

That's it. Memory, budgeting, and safe execution are already on.

</td>
</tr>
</table>

Prefer one-liner installs? `curl -fsSL https://nexus-prime.cfd/install.sh | bash`

---

## Features

<table>
<tr>
<td width="33%" valign="top">

### 🧠 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">

### 💰 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">

### 🛡️ 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">

### 🔌 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">

### 🏠 Your code, your machine

Everything runs locally. No cloud. No telemetry without your consent. No vendor lock-in.

</td>
<td width="33%" valign="top">

### 👁️ 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">

### 🤝 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">

### 🧬 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

Install, run `setup all`, done. The wizard detects every coding agent on your machine and wires each one.

</td>
</tr>
</table>

---

## See it in action

<div align="center">
  <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>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 — why the agent chose what it read" width="1024">
  <br>
  <sub><b>The receipts</b> — every decision is traced, so you can see <i>why</i> your agent did what it did.</sub>
</div>

---

## Works with

Nexus Prime wires up every major coding agent with one command:

<div align="center">

| | | |
|:---:|:---:|:---:|
| **Claude Code** | **Cursor** | **Codex** |
| **Windsurf** | **OpenCode** | **Antigravity** |
| **Aider** | **Continue.dev** | **Cline** |

</div>

Pick one: `nexus-prime setup claude` · `setup cursor` · `setup codex` · `setup windsurf` · `setup opencode` · `setup antigravity` · `setup aider` · `setup continue` · `setup cline`

Or just wire everything: **`nexus-prime setup all`**

---

## What users see

Numbers from real users running real workflows on their own machines:

| 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 |

No benchmarks from a press release — this is what the dashboard shows you, on day one.

---

## Competitive position

Nexus Prime is a local-first control plane for coding agents: persistent memory, workspace-scoped runtime state, dashboard observability, and MCP-native orchestration in one install. The public comparison page tracks where it differs from other agent frameworks and developer orchestrators: https://nexus-prime.cfd/comparison.html

---

## Who it's for

Nexus Prime is for people who take AI-assisted coding seriously:

- **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

If any of that sounds like you — keep reading.

---

## Pricing

<div align="center">

**3-day no-license grace. Request a license before day 4. Manual approvals within 24 hours.**

</div>

<table>
<tr>
  <th>Plan</th>
  <th>Who it's for</th>
  <th>Price</th>
  <th>Caps</th>
</tr>
<tr>
  <td><b>🎁 Local Grace</b></td>
  <td>Everyone — install and verify locally</td>
  <td>3 days without a license</td>
  <td>Runtime available during grace; license required after day 3</td>
</tr>
<tr>
  <td><b>💎 Independent Creators</b></td>
  <td>Indie builders, solo engineers, students, OSS maintainers</td>
  <td>Request access</td>
  <td>Manual creator licenses reviewed by the team</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>

```bash
nexus-prime license status          # check your plan
nexus-prime license activate <key>  # activate the key shared by the team
```

→ **[nexus-prime.cfd/account](https://nexus-prime.cfd/account)** · **[Request by email](mailto:adarsh@nexus-prime.cfd?subject=Nexus%20Prime%20license%20request)**

---

## FAQ

<details>
<summary><b>Will my code ever leave my machine?</b></summary>
<br>
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>Does this replace Claude Code, Cursor, or my IDE?</b></summary>
<br>
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>What happens after the 30-day trial ends?</b></summary>
<br>
The local trial window ends and paid-tier work requires an active license. Your local memory and data stay on your machine; activate a license or request renewal from the account page to continue.
</details>

<details>
<summary><b>Is it free for indie developers and creators?</b></summary>
<br>
Creator access is reviewed manually. If you build independently — solo founder, indie dev, content creator, student, OSS maintainer — request a creator license from the account page or email <a href="mailto:adarsh@nexus-prime.cfd?subject=Creator%20Program">adarsh@nexus-prime.cfd</a>.
</details>

<details>
<summary><b>My team wants to try this across the whole engineering org. What's the pilot?</b></summary>
<br>
We're taking <b>10 companies</b> into our pilot program — white-glove onboarding, direct access to the team building it, and team licenses issued after review. <a href="mailto:adarsh@nexus-prime.cfd?subject=Pilot%20Program">Reach out</a>.
</details>

<details>
<summary><b>Will it actually speed my agent up?</b></summary>
<br>
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>Does it work on Windows?</b></summary>
<br>
Yes — Windows, macOS, and Linux are all first-class. Node 20+ is the only requirement.
</details>

<details>
<summary><b>Can multiple team members share state?</b></summary>
<br>
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>

<details>
<summary><b>What if I hit my plan's cap?</b></summary>
<br>
The app shows an upgrade request path and keeps your local data intact. Features above your licensed tier require an approved upgrade.
</details>

<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>

---

## Privacy

Nexus Prime was designed privacy-first, because the code on your machine is yours:

- 🏠 **100% local.** All data lives on your disk, in your home directory.
- 🚫 **No cloud sync.** Your code, your memory, your logs — never uploaded.
- 🔐 **Short no-account grace.** You can run locally for 3 days without signing up; a license is required after that grace period.
- 📊 **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.

---

## Community & support

<div align="center">

| 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/getnexusprime) | Launch announcements, tips, updates |
| 📸 [**Instagram**](https://www.instagram.com/nexus_prime.cfd/) | Product clips, launch updates, behind-the-scenes |
| 📧 [**adarsh@nexus-prime.cfd**](mailto:adarsh@nexus-prime.cfd) | License requests, upgrades, pilots, enterprise |
| 📧 [**hello@nexus-prime.cfd**](mailto:hello@nexus-prime.cfd) | General support, press, community |
| 🌐 [**nexus-prime.cfd**](https://nexus-prime.cfd) | Product site, demos, pricing, setup guides |

</div>

---

## License

Nexus Prime is a **commercial product** with manual license issuance:

- ✅ 3-day local no-license grace, for everyone
- ✅ Manual creator, pilot, team, and enterprise license review
- ✅ License and upgrade requests reviewed within 24 hours
- 💳 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. · Local-first. · Privacy-first. · Cloud-free.</sub>

<br><br>

<sub>If Nexus Prime ends your agent's amnesia, tell another engineer. That's how good tools spread. 🧠</sub>

</div>
