nexus-prime is a local-first control plane for coding agents. It gives AI coding assistants like Claude Code, Cursor, Codex, and Windsurf persistent memory, token-optimized context routing, isolated git worktree execution, and cross-agent session continuity — all in one npm package with zero API keys required.

How do I install nexus-prime?

Install with: npm i -g nexus-prime. Then run nexus-prime setup claude (or cursor, codex, windsurf) to wire the MCP server. The free tier is available forever with no credit card required.

Does nexus-prime require an API key?

No. nexus-prime is fully local-first. It runs on your machine, uses SQLite for storage, and requires zero API keys. Nothing leaves your machine without your explicit consent.

Which AI coding agents does nexus-prime support?

nexus-prime supports 12+ coding agents including Claude Code, Cursor, Codex, Windsurf, Cline, Antigravity, OpenClaw, and more. Setup is one command per agent: nexus-prime setup <agent-name>.

What is Session DNA in nexus-prime?

Session DNA is nexus-prime's cross-agent context transfer mechanism. When you end a session in Claude Code and start one in Cursor, nexus-prime transfers all facts, decisions, and context instantly — so you pick up exactly where you left off without any re-reading.

How does nexus-prime reduce token usage?

nexus-prime uses Token Supremacy — a source-aware budgeting system combining CAS compression and greedy knapsack allocation. Instead of reading all files every session, it routes only the semantically relevant file set. One developer tracked 99.4% of 100M tokens were inputs (re-reading). nexus-prime eliminates that.

Give your agent
continuity.

Nexus Prime is the local-first control plane that anchors your agent to reality with persistent state, orchestrated worktrees, and an immutable audit trail.

99.4%

Less Re-reading

12+

Agents Supported

API Keys Required

—

Lifetime Downloads

Adopted by builders at

IIM Ahmedabad

rezo.ai

IIT Delhi

Qure.ai

finbox.in

IIT Gandhinagar

IIM Kozhikode

IIM Ahmedabad

orbo.ai

IIT Delhi

Qure.ai

finbox.in

IIT Gandhinagar

IIM Kozhikode

1 / 6 — The Manifesto

The Context Window is a Trap.

Every time an agent takes an action, it re-reads everything from scratch. It pays full price for orientation on every turn.

01 // The Re-reading Loop

166 tokens read for 1 written.

One developer tracked 100M tokens — 99.4% were input. The agent is not building understanding; it is stuck in an infinite orientation tax loop.

02 // The Accumulation Trap

Memory becomes noise.

Agents form memory, but nobody configures decay. A note from six months ago outranks yesterday's critical update. The session starts heavier.

03 // The Portability Gap

Tokens expire. Context dies.

Switch from Claude Code to Codex. The repo transfers, but which files mattered? What did you already try? The context does not travel.

04 // RAG Stuffing

More context = worse logic.

Collections get injected wholesale into context. Irrelevant context degrades model reasoning. Flat files like CLAUDE.md just formalize the stuffing.

2 / 6 — The Pipeline

Stop treating memory as ephemeral context.

The brilliant programmer who gets blackout drunk every night and wakes up not knowing what project they are working on. That is your current AI infrastructure.

Standard Agents

Read Everything

Agent parses 25 untouched files to answer a question that required 3.

Execute Blindly

Direct mutation of the main working tree. High risk of breaking state.

Session Terminated

Terminal closes. Discoveries, decisions, and context are lost forever.

Start From Zero

Next session pays the exact same token cost to re-learn the repo.

Nexus Prime Orchestration

Ghost Pass

Pre-read analysis routes only semantically relevant files to the context window.

Worktree Isolation

Nexus spawns an isolated git worktree. The agent builds without touching main.

State Extraction

Facts are extracted, scored, and reconciled. Contradictions are pruned.

Session DNA

Context transfers instantly. Switch from Cursor to Cline and pick up exactly where you left off.

3 / 6 — The Validation

Tested by builders.
Verified by auditors.

StrictSeal Technical Audit

Nexus-prime has been reviewed and approved.

"We installed the global npm package and verified the CLI toolset ourselves. The MCP server handles memory and token orchestration correctly. GitHub activity shows 27 consistent releases."

u/ultrathink-artr/LLMDevs

"The bounded execution piece is the most valuable part of this architecture - unbounded agents accumulate stale context that silently distorts later decisions...."

rezo.ai EngineeringDirect Message

"We wired Nexus into our agent pipeline and the token savings were immediately measurable. The ghost-pass worktree isolation is exactly what we needed for safe multi-agent execution."

u/Otherwise_Waver/Adulting

"This is a really interesting direction, control planes for coding agents feel like the missing middle layer between 'chat in an IDE' and actual reliable automation."

u/Time-Dot-1808r/LocalLLaMA

"The core problem is that 'session' as a unit of work does not map to 'task'. A feature spans days, not hours..."

u/ultrathink-artr/LLMDevs

"The bounded execution piece is the most valuable part of this architecture - unbounded agents accumulate stale context that silently distorts later decisions...."

rezo.ai EngineeringDirect Message

"We wired Nexus into our agent pipeline and the token savings were immediately measurable. The ghost-pass worktree isolation is exactly what we needed for safe multi-agent execution."

u/Otherwise_Waver/Adulting

"This is a really interesting direction, control planes for coding agents feel like the missing middle layer between 'chat in an IDE' and actual reliable automation."

u/Time-Dot-1808r/LocalLLaMA

"The core problem is that 'session' as a unit of work does not map to 'task'. A feature spans days, not hours..."

4 / 6 — The Architecture

The Strata of Intelligence.

Nexus Prime is not a wrapper. It is a fundamental phase transition in how agents interact with the host system.

LAYER 01 SQLite Memory Ledger (Durable State)

LAYER 02 Source-Aware Token Budgets (Decay Logic)

LAYER 03 Isolated Git Worktrees (Bounded Execution)

LAYER 04 Multi-Agent Control Plane (Session DNA)

5 / 6 — Telemetry

Inspect everything.
Trust nothing.

Keep a run log of decisions, patches, and tool calls. Rebuild context from artifacts every step.

github pages // NEXUS_COCKPIT // v6.0.0 SYSTEM_ONLINE

State Topology Lattice

STATE RECONCILIATION: 23 FACTS VALIDATED, 2 QUARANTINED

Token Telemetry

58K CANDIDATE → 40K ALLOCATED (31% COMPRESSED)

Audit Trail (Run Log)

[OK] Bootstrap recovered 23 facts

[OK] Ghost Pass filtered 42 files

[OK] Orchestrator routed 109 skills

[EXEC] Worktree spawned on branch nx-01

6 / 6 — The Reality Check

What you are missing.

Capability	Nexus Prime	Standard Agents	Basic MCP Servers
Cross-Agent Context Transfer	+ Native DNA	-	-
Persistent Memory with Decay	+ SQLite Fabric	-	-
Source-Aware Token Routing	+ Local TF-IDF	-	-
Worktree-Backed Execution	+ Isolated	-	-
Runtime Truth Provenance	+ Ledger Log	- Ephemeral	-
Auto-Setup for 12+ Agents	+ 1 Command	- N/A	- Partial

Give your agent continuity.