Nexus Prime

Local-first MCP control plane for coding agents

Bootstrap. Orchestrate. Verify. Learn.

---

The problem with coding agents today

Every coding agent eventually hits the same ceiling. Not model quality — infrastructure.

The re-reading loop. Agents have no persistent memory. Every action requires re-reading all relevant context from scratch. One developer tracked 100M tokens across a Claude Code session: 99.4% were input. For every 1 token written, 166 were read. The agent was not building understanding — it was paying full orientation cost on every single turn.

The memory accumulation trap. Agents form memory, but nobody decides what should stick. A note from six months ago with a strong semantic match can outrank yesterday's update on the same topic — unless you explicitly configure decay. Memory becomes a growing archive of noise, and the next session starts heavier, not smarter.

The portability gap. Token expires. You switch from Claude Code to Codex. The repo transfers. What doesn't: which files actually mattered, what was already tried, what decisions were made at 2am that you built on top of.

RAG as prompt stuffing. Collections get injected wholesale into context. Research consistently shows irrelevant context doesn't just waste tokens — it makes the model behave as if it were a worse model. More context, worse performance.

Skill selection stays manual. Hundreds of skills exist. Nobody auto-selects. You tell the agent what to use, which defeats the purpose of orchestration.

Why existing solutions don't solve this

Problem	Common workaround	Why it fails	Nexus Prime
Re-reading loop	CLAUDE.md, AGENTS.md	Static files, manually updated, still re-read every turn	Session bootstrap with source-aware token budgeting — tracks what was selected and what was dropped
Memory accumulation	Flat markdown files (OpenClaw)	No decay logic, no prominence scoring, no reconciliation	Memory fabric with fact extraction, conflict detection, quarantine, and configurable decay
Memory portability	Mem0, MemoryPlugin	Built for conversation continuity, not coding workflow state — architecture decisions and file maps don't transfer	Session DNA for cross-agent context transfer
RAG stuffing	Paste collections into context	Irrelevant context actively degrades model performance	RAG gate — collections attached, retrieved only when relevant, traced through packet and provenance
Skill selection	Manual — you pick the skill	Doesn't scale, brittle, defeats orchestration purpose	nexus_orchestrate decomposes task and auto-selects skills, workflows, crews, specialists
Token overflow	Start fresh with new agent	All learned context lost, repo transfers but workflow state doesn't	Ghost pass decides what files even need reading before reading them

What Nexus Prime is

Nexus Prime is a local-first MCP control plane for coding agents. It gives clients a default path that starts with bootstrap context, flows through orchestrated execution, and ends with persisted runtime truth instead of ad-hoc tool chaining.

Website: nexus-prime.cfd
Documentation: Catalog · Comparison · Knowledge Base · Integrations · Architecture Diagrams

⚡ Quick Install

# Global installation (recommended)
npm i -g nexus-prime

# Start the MCP server
npx nexus-prime mcp

Home-scoped bootstrap now runs automatically on install or first binary start, and the first Nexus run inside a repo writes the workspace-scoped client files it needs. nexus-prime setup <client> and nexus-prime setup all remain the explicit refresh/fix path when you want to force regeneration.

Docker

docker compose up                              # Nexus Prime only
docker compose --profile with-ollama up        # Nexus Prime + local Ollama

Embedding backends

Nexus Prime supports multiple embedding backends with automatic fallback:

Backend	Config	Default model
Local TF-IDF	NEXUS_EMBED_MODE=local (default)	Built-in 128-dim
Ollama	NEXUS_EMBED_MODE=ollama	nomic-embed-text
HuggingFace	NEXUS_EMBED_MODE=huggingface	sentence-transformers/all-MiniLM-L6-v2
OpenAI	NEXUS_EMBED_MODE=api	text-embedding-3-small

# Ollama (requires ollama running locally)
NEXUS_EMBED_MODE=ollama NEXUS_OLLAMA_ENDPOINT=http://localhost:11434 npx nexus-prime mcp

# HuggingFace Inference API
NEXUS_EMBED_MODE=huggingface NEXUS_HF_API_KEY=hf_... npx nexus-prime mcp

Fallback chain: Ollama → HuggingFace → OpenAI → Local TF-IDF. If the preferred backend is unavailable, Nexus falls through automatically.

Default bootstrap-orchestrate path

nexus_session_bootstrap(goal="<task>", files=[...])
nexus_orchestrate(prompt="<raw user request>")

Use nexus_plan_execution only when you explicitly want the ledger before mutation. Let Nexus choose crews, specialists, skills, workflows, hooks, automations, worker count, and token strategy unless you need hard constraints.

Core Capabilities

1. The re-reading loop → Session Bootstrap

Problem: Without persistent context, agents re-read everything from scratch on every turn. 99%+ of tokens spent on orientation, not problem-solving. How: nexus_session_bootstrap recovers memory, catalog health, source mix, and recommended next step before any work begins. nexus_orchestrate owns decomposition, asset selection, execution, and verification. Proof: Runtime ledgers, worker plans, and selection audits persisted into runtime truth.

2. Files read without question → Ghost Pass + Token Budgeting

Problem: Agents read 25 files to answer a question that needed 3. No pre-read analysis. No decision about whether a file should even be read. How: nexus_ghost_pass runs a pre-read analysis pass. Source-aware token budgeting then allocates budget across repo, memory, RAG, patterns, and runtime traces — recording what was selected and what was dropped. Tiered context loading (L0/L1/L2) progressively deepens reads based on relevance instead of loading everything at full depth. Background context compaction strips low-signal content while retaining structural elements. Proof: Lifetime token analytics with per-session breakdowns, compression ratios, and USD savings — persisted in SQLite, surviving restarts.

3. Memory that grows but never learns → Memory Fabric

Problem: Memory accumulates without decay. Old notes outrank recent updates. No mechanism for deciding what's ephemeral vs. durable. How: The memory control plane applies fact extraction, reconciliation, quarantine, and vault projection on top of SQLite + graph base. Memories are scored, contradictions detected, and stale facts fade. A compaction sentinel flushes working memory to durable storage before context window compaction. Background maintenance runs on a 5-minute cycle for entropy-based expiration and deduplication. Proof: Dashboard exposes memory health, scope, trace, and shared-worker context.

4. RAG as prompt stuffing → Session-First RAG Gate

Problem: Collections get injected wholesale. Irrelevant context doesn't just waste tokens — it degrades model performance. How: Collections are attached to the runtime, retrieved only when relevant, and traced into planner, packet, and provenance. Nothing gets dumped into prompts wholesale. Proof: Knowledge view records attached, retrieved, selected, and dropped context.

5. Multi-file work pollutes the checkout → Worktree-Backed Swarms

Problem: Multi-file changes in a single checkout create merge conflicts, partial states, and untestable intermediate commits. How: Coder and verifier lanes execute in isolated worktrees with explicit worktree-health pass before creation. Proof: Runtime records worktree health, degraded fallback, verifier status, and merge/apply outcomes.

6. Runtime state lives in the host process → Persisted Runtime Truth

Problem: When the process dies, the truth dies. Operators can't inspect what happened after the fact. How: Packets, ledgers, token summaries, client bootstrap truth, worktree health, and run snapshots all come from persisted runtime state. Proof: Dashboard shows graph-first context, execution history, governance, and catalog truth from the same runtime ledger.

7. Manual bootstrap per client → Client Bootstrap and MCP Profiles

Problem: Users manually copy config files for every coding agent. One wrong path and the agent silently ignores the MCP server. How: Install/start establishes home-scoped surfaces, first repo run writes workspace-scoped surfaces, and setup all remains the explicit repair path. Proof: 9 agents configured automatically: Codex, Cursor, Claude Code, Opencode, Windsurf, Antigravity/OpenClaw, Aider, Continue.dev, Cline.

8. Ship path disconnected from product story → Release and Governance Surfaces

Problem: Feature registry, public docs, and release notes drift from actual runtime state. How: Feature registry generation, public-surface scans, release smoke, dependency audit, and runtime smoke all sit in the release gate. Proof: README, docs, dashboard catalog, and release notes all consume the same generated inventory.

Proof Screens

Graph-centered cockpit view: the dashboard keeps memory context, runtime truth, and operator controls in one place instead of hiding them behind separate tools.

Knowledge and token trace view: Nexus shows what attached collections contributed, what token budgeting kept, and what the runtime dropped.

• Catalog: generated registry for MCP surfaces, client targets, dashboard capabilities, runtime subsystems, and release gates.
• Comparison: tiered market map for direct developer orchestrators, broader multi-agent frameworks, and adjacent specialist stacks.
• Knowledge Base: runtime contract, packets, ledgers, memory, token telemetry, and guardrails.
• Integrations: verified setup for Codex, Cursor, Claude Code, Opencode, Windsurf, and Antigravity/OpenClaw.
• Architecture Diagrams: shipped diagrams for the control plane, worktree lifecycle, memory fabric, RAG gate, token budget, runtime truth, and release pipeline.

📐 Diagram: bootstrap → orchestrate → runtime → truth

flowchart LR
    Client["Client"] --> Bootstrap["nexus_session_bootstrap"]
    Bootstrap --> Plan["nexus_plan_execution (optional)"]
    Bootstrap --> Orchestrate["nexus_orchestrate"]
    Plan --> Orchestrate
    Orchestrate --> Runtime["Worktree-backed runtime"]
    Runtime --> Dashboard["Dashboard + API truth"]
    Runtime --> Memory["Memory fabric + session DNA"]
    Runtime --> Client

Loading

🧠 Diagram: memory + RAG + token-budget flow

flowchart TD
    Repo["Repo files"] --> Fabric["Knowledge Fabric"]
    Memory["Memory recall + stats"] --> Fabric
    Rag["Attached RAG collections"] --> Fabric
    Patterns["Patterns + runtime traces"] --> Fabric
    Fabric --> Budget["Source-aware token budget"]
    Budget --> Packet["Instruction packet"]
    Budget --> Runtime["Runtime execution"]
    Runtime --> Truth["Provenance + runtime truth"]

Loading

Client Setup and Runtime Contract

Supported MCP Clients

Nexus Prime provides automated setup for 12 coding agents:

• 🔴 Codex
• 🔵 Cursor
• 🍊 Claude Code (CLI + Desktop + VS Code extension)
• 🟢 Opencode
• 🌊 Windsurf
• 🛡️ Antigravity / OpenClaw
• 🔧 Aider
• 🔗 Continue.dev
• ⚙️ Cline

All agent configurations are written automatically on npm install with XDG-aware path resolution. The first Nexus run inside a repo writes workspace-scoped client files. nexus-prime setup <client> and nexus-prime setup all remain the explicit refresh/fix path. Run nexus-prime setup diagnose for a dry-run validation of all client paths.

Automated Integration

nexus-prime setup codex
nexus-prime setup cursor
nexus-prime setup claude
nexus-prime setup windsurf
nexus-prime setup antigravity
nexus-prime setup aider
nexus-prime setup continue
nexus-prime setup cline
nexus-prime setup all
nexus-prime setup status

Runtime contract

1. nexus_session_bootstrap(goal, files?)
2. nexus_orchestrate(prompt)
3. Persist packet, ledger, token telemetry, provenance, and session DNA
4. Inspect runtime truth in the dashboard or via MCP

Operator-facing proof

Called Nexus Session Bootstrap tool from Nexus Prime MCP

Session bootstrap ready.
- Client: Codex (primaryActive)
- Recommended next step: nexus_orchestrate
- Token optimization: required
- Knowledge fabric: repo

Called Nexus Memory Stats tool from Nexus Prime MCP

Memory inventory ready.
- Prefrontal: working set
- Hippocampus: recent session buffer
- Cortex: durable long-term store
- Zettelkasten links: persisted graph relationships

Competitive Landscape

Mem0 ($24M Series A, AWS Agent SDK exclusive) solves conversation memory — user preferences, chat continuity, multi-session recall. It was not built for coding workflow state: architecture decisions, file relevance maps, what was tried and failed.

OpenClaw's memory system stores flat markdown files with optional temporal decay. It is siloed per agent and does not transfer between coding tools.

The entire category treats memory as a local storage problem rather than a knowledge architecture problem.

Nexus Prime is not a memory layer. It is the control plane that sits between the client and the repo — owning bootstrap, orchestration, worktree execution, and persisted runtime truth. Memory is one subsystem within it, not the product.

Read the full tiered market map: Comparison

🧭 Platform Feature Registry

Generated from shared feature metadata at 2026-03-21T02:48:13.064Z.

Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews · 139 specialists

Control Plane Snapshot: 9 MCP surfaces · 6 client targets · 5 dashboard capabilities · 6 runtime subsystems · 5 release gates

MCP Surfaces (9)

Operator-facing entrypoints and expert control surfaces.

Name	Surface	Purpose	Notes
nexus_session_bootstrap	core MCP	Recover session context, memory stats, catalog health, and next-step guidance.	Default first call for non-trivial work.
nexus_orchestrate	core MCP	Plan, select assets, execute through worktree-backed runtime, and persist truth.	Default raw-prompt execution path.
nexus_plan_execution	planning MCP	Inspect the planner ledger before mutation.	Used when operators want a pre-run ledger.
nexus_recall_memory / nexus_memory_stats / nexus_store_memory	memory MCP	Inspect and persist durable learnings.	Feeds the memory fabric and handoff flow.
nexus_optimize_tokens	optimization MCP	Generate a token-saving reading plan before broad file inspection.	Mandatory before reading 3+ files from client-visible intent.
nexus_mindkit_check / nexus_ghost_pass / nexus_spawn_workers	safety + runtime MCP	Run governance preflight, refactor pre-flight analysis, and explicit swarm control.	Mindkit and ghost-pass are required lifecycle checks for risky or multi-file mutation.
nexus_memory_export / import / backup / maintain / trace	memory portability MCP	Export, restore, maintain, and inspect local-first memory bundles.	Supports backup/resume and OpenClaw-oriented bridge packs.
nexus_list_skills / workflows / hooks / automations / specialists / crews	catalog MCP	Expose what the runtime can activate.	Used for explicit operator control and diagnostics.
nexus_run_status / nexus_federation_status / nexus_session_dna	runtime truth MCP	Inspect persisted run state, federation status, and handoff DNA.	Session DNA generation is mandatory before ending a meaningful session.

Client Bootstrap Targets (6)

Client-native installation and bootstrap surfaces managed by Nexus Prime.

Name	Surface	Purpose	Notes
Codex	bootstrap target	Writes a managed Nexus Prime block into repo-local AGENTS.md.	Workspace-scoped bootstrap.
Cursor	bootstrap target	Installs MCP config plus project-local .cursor/rules/nexus-prime.mdc.	Home + workspace surfaces.
Claude Code	bootstrap target	Installs MCP config plus generated markdown bootstrap note.	Project note under .agent/client-bootstrap.
Opencode	bootstrap target	Installs config plus generated markdown bootstrap note.	Project note under .agent/client-bootstrap.
Windsurf	bootstrap target	Installs MCP config plus .windsurfrules.	Workspace-scoped rule surface.
Antigravity / OpenClaw	bootstrap target	Installs MCP config plus split SKILL.md bundles sized to client limits.	Home-scoped skill bundle.

Dashboard Capabilities (5)

What the topology console exposes from persisted runtime truth.

Name	Surface	Purpose	Notes
Overview	dashboard	Runtime truth, lifetime token telemetry, graph-centered memory view, and system signals.	Default operator cockpit.
Knowledge	dashboard	Session-first RAG workflow, provenance, source mix, and bootstrap manifest truth.	Shows attached, retrieved, selected, and dropped context.
Runs	dashboard	Execution topology, verifier traces, and event stream.	Centered on persisted runtime snapshots.
Catalog	dashboard	Loaded assets, feature registry, and runtime-vs-available inventory.	Separates what exists from what was used.
Governance	dashboard	Guardrails, quarantine, federation health, and client bootstrap drift.	Operator-facing trust layer.

Runtime Subsystems (7)

Core architecture layers that shape execution, memory, and visibility.

Name	Surface	Purpose	Notes
Knowledge Fabric	runtime subsystem	Balances repo, memory, RAG, patterns, and runtime traces into one execution bundle.	Feeds planner, packet, and worker context.
Memory Control Plane	runtime subsystem	Reconciles facts with add/update/merge/delete/quarantine semantics and vault projection.	Local-first memory remains inspectable and portable.
Worktree Doctor	runtime subsystem	Prunes stale git worktree metadata and records worktree health ahead of execution.	Protects nexus_orchestrate and verifier lanes from stale temp state.
Source-Aware Token Budget	runtime subsystem	Allocates token budget across repo, memory, RAG, patterns, and runtime traces.	Persists selected and dropped context.
Bootstrap Manifest Truth	runtime subsystem	Tracks configured client bootstrap artifacts independently from active heartbeats.	Supports installed vs active truth in the dashboard.
Artifact Selection Audit	runtime subsystem	Explains why skills/workflows/crews/specialists were selected or rejected.	Persists auditable selection rationale.
Bundled assets: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews · 139 specialists	runtime subsystem	Summarizes the current bundled runtime inventory.	Detailed lists live in the runtime catalog section and dashboard catalog view.

Release Gates (5)

Quality and security checks required before release.

Name	Surface	Purpose	Notes
Build + lint + tests	release gate	Compile, lint, and validate runtime/docs/public surfaces.	Canonical quality matrix.
Package smoke	release gate	Verify npm packaging via dry-run before publish.	Catches release surface drift.
Dependency audit + SBOM	release gate	Track shipping dependency risk and document exceptions.	Security hardening gate.
Workflow lint	release gate	Validate workflow syntax and release automation contracts.	Protects CI/CD drift.
Runtime smoke	release gate	Exercise MCP startup, setup-all bootstrap, and dashboard boot.	Final operator-facing release check.

---

🗂 Runtime Catalog

Generated from bundled runtime catalogs plus repo-local overrides via npm run generate:readme-catalog.

Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews

Skills (109)

Name	Type/Scope	Purpose	Trigger / When used
Agent Orchestrator	read · base	🛰️ Agent Orchestrator	orchestration work or explicit selection
AI Lead	read · base	🤖 AI Lead	ai work or explicit selection
ai-builder	mutate · base	Operate as the ai builder with bounded mutations and verifier discipline.	ai work or explicit selection
ai-playbook	orchestrate · base	Operate as the ai specialist for this run.	ai work or explicit selection
ai-reviewer	read · base	Review ai outputs for accuracy, credibility, and completeness.	ai work or explicit selection
api-builder	orchestrate · base	Operate as the api builder with bounded mutations and verifier discipline.	api work or explicit selection
api-playbook	orchestrate · base	Operate as the api specialist for this run.	api work or explicit selection
api-reviewer	read · base	Review api outputs for accuracy, credibility, and completeness.	api work or explicit selection
Backend Inspector	read · base	⚙️ Backend Inspector	backend work or explicit selection
backend-builder	mutate · base	Operate as the backend builder with bounded mutations and verifier discipline.	backend work or explicit selection
backend-playbook	orchestrate · base	Operate as the backend specialist for this run.	backend work or explicit selection
backend-reviewer	read · base	Review backend outputs for accuracy, credibility, and completeness.	backend work or explicit selection
Business Analyst	read · base	📊 Business Analyst	runtime selection or explicit skill selection
CLI/Node Reviewer	read · base	📟 CLI/Node Reviewer	node work or explicit selection
Code Review Agent	read · base	🔍 Code Review Agent	orchestration work or explicit selection
Context Manager	read · base	📦 Context Manager	runtime selection or explicit skill selection
CTO/CEO Strategy	read · base	👔 CTO/CEO Strategy	strategy work or explicit selection
data-builder	orchestrate · base	Operate as the data builder with bounded mutations and verifier discipline.	data work or explicit selection
data-playbook	orchestrate · base	Operate as the data specialist for this run.	data work or explicit selection
data-reviewer	read · base	Review data outputs for accuracy, credibility, and completeness.	data work or explicit selection
deep-tech-builder	orchestrate · base	Operate as the deep-tech builder with bounded mutations and verifier discipline.	deep-tech work or explicit selection
deep-tech-playbook	orchestrate · base	Operate as the deep-tech specialist for this run.	deep-tech work or explicit selection
deep-tech-reviewer	read · base	Review deep-tech outputs for accuracy, credibility, and completeness.	deep-tech work or explicit selection
design-builder	orchestrate · base	Operate as the design builder with bounded mutations and verifier discipline.	design work or explicit selection
design-playbook	orchestrate · base	Operate as the design specialist for this run.	design work or explicit selection
design-reviewer	read · base	Review design outputs for accuracy, credibility, and completeness.	design work or explicit selection
DevOps Auditor	read · base	🚀 DevOps Auditor	runtime selection or explicit skill selection
django-builder	mutate · base	Operate as the django builder with bounded mutations and verifier discipline.	django work or explicit selection
django-playbook	orchestrate · base	Operate as the django specialist for this run.	django work or explicit selection
django-reviewer	read · base	Review django outputs for accuracy, credibility, and completeness.	django work or explicit selection
economics-builder	orchestrate · base	Operate as the economics builder with bounded mutations and verifier discipline.	economics work or explicit selection
economics-playbook	orchestrate · base	Operate as the economics specialist for this run.	economics work or explicit selection
economics-reviewer	read · base	Review economics outputs for accuracy, credibility, and completeness.	economics work or explicit selection
finance-builder	orchestrate · base	Operate as the finance builder with bounded mutations and verifier discipline.	finance work or explicit selection
finance-playbook	orchestrate · base	Operate as the finance specialist for this run.	finance work or explicit selection
finance-reviewer	read · base	Review finance outputs for accuracy, credibility, and completeness.	finance work or explicit selection
Frontend Auditor	read · base	🖥️ Frontend Auditor	frontend work or explicit selection
frontend-builder	mutate · base	Operate as the frontend builder with bounded mutations and verifier discipline.	frontend work or explicit selection
frontend-playbook	orchestrate · base	Operate as the frontend specialist for this run.	frontend work or explicit selection
frontend-reviewer	read · base	Review frontend outputs for accuracy, credibility, and completeness.	frontend work or explicit selection
game-development-builder	mutate · base	Operate as the game-development builder with bounded mutations and verifier discipline.	game-development work or explicit selection
game-development-playbook	orchestrate · base	Operate as the game-development specialist for this run.	game-development work or explicit selection
game-development-reviewer	read · base	Review game-development outputs for accuracy, credibility, and completeness.	game-development work or explicit selection
gtm-builder	orchestrate · base	Operate as the gtm builder with bounded mutations and verifier discipline.	gtm work or explicit selection
gtm-playbook	orchestrate · base	Operate as the gtm specialist for this run.	gtm work or explicit selection
gtm-reviewer	read · base	Review gtm outputs for accuracy, credibility, and completeness.	gtm work or explicit selection
integrations-builder	orchestrate · base	Operate as the integrations builder with bounded mutations and verifier discipline.	integrations work or explicit selection
integrations-playbook	orchestrate · base	Operate as the integrations specialist for this run.	integrations work or explicit selection
integrations-reviewer	read · base	Review integrations outputs for accuracy, credibility, and completeness.	integrations work or explicit selection
marketing-builder	orchestrate · base	Operate as the marketing builder with bounded mutations and verifier discipline.	marketing work or explicit selection
marketing-playbook	orchestrate · base	Operate as the marketing specialist for this run.	marketing work or explicit selection
marketing-reviewer	read · base	Review marketing outputs for accuracy, credibility, and completeness.	marketing work or explicit selection
Memory Architect	read · base	🏗️ Memory Architect	runtime selection or explicit skill selection
node-builder	mutate · base	Operate as the node builder with bounded mutations and verifier discipline.	node work or explicit selection
node-playbook	orchestrate · base	Operate as the node specialist for this run.	node work or explicit selection
node-reviewer	read · base	Review node outputs for accuracy, credibility, and completeness.	node work or explicit selection
orchestration-builder	orchestrate · base	Operate as the orchestration builder with bounded mutations and verifier discipline.	orchestration work or explicit selection
orchestration-playbook	orchestrate · base	Operate as the orchestration specialist for this run.	orchestration work or explicit selection
orchestration-reviewer	read · base	Review orchestration outputs for accuracy, credibility, and completeness.	orchestration work or explicit selection
paid-media-builder	orchestrate · base	Operate as the paid-media builder with bounded mutations and verifier discipline.	paid-media work or explicit selection
paid-media-playbook	orchestrate · base	Operate as the paid-media specialist for this run.	paid-media work or explicit selection
paid-media-reviewer	read · base	Review paid-media outputs for accuracy, credibility, and completeness.	paid-media work or explicit selection
pdlc-builder	orchestrate · base	Operate as the pdlc builder with bounded mutations and verifier discipline.	pdlc work or explicit selection
pdlc-playbook	orchestrate · base	Operate as the pdlc specialist for this run.	pdlc work or explicit selection
pdlc-reviewer	read · base	Review pdlc outputs for accuracy, credibility, and completeness.	pdlc work or explicit selection
PM Agent	read · base	📋 PM Agent	orchestration work or explicit selection
product-builder	orchestrate · base	Operate as the product builder with bounded mutations and verifier discipline.	product work or explicit selection
product-playbook	orchestrate · base	Operate as the product specialist for this run.	product work or explicit selection
product-reviewer	read · base	Review product outputs for accuracy, credibility, and completeness.	product work or explicit selection
python-builder	mutate · base	Operate as the python builder with bounded mutations and verifier discipline.	python work or explicit selection
python-playbook	orchestrate · base	Operate as the python specialist for this run.	python work or explicit selection
python-reviewer	read · base	Review python outputs for accuracy, credibility, and completeness.	python work or explicit selection
QA/Testing Agent	read · base	🧪 QA/Testing Agent	testing work or explicit selection
react-builder	mutate · base	Operate as the react builder with bounded mutations and verifier discipline.	react work or explicit selection
react-playbook	orchestrate · base	Operate as the react specialist for this run.	react work or explicit selection
react-reviewer	read · base	Review react outputs for accuracy, credibility, and completeness.	react work or explicit selection
Rule Sanitizer	read · base	🧹 Rule Sanitizer	runtime selection or explicit skill selection
sales-builder	orchestrate · base	Operate as the sales builder with bounded mutations and verifier discipline.	sales work or explicit selection
sales-playbook	orchestrate · base	Operate as the sales specialist for this run.	sales work or explicit selection
sales-reviewer	read · base	Review sales outputs for accuracy, credibility, and completeness.	sales work or explicit selection
security-builder	orchestrate · base	Operate as the security builder with bounded mutations and verifier discipline.	security work or explicit selection
security-playbook	orchestrate · base	Operate as the security specialist for this run.	security work or explicit selection
security-reviewer	read · base	Review security outputs for accuracy, credibility, and completeness.	security work or explicit selection
Skill Registry	read · base	📋 Skill Registry	runtime selection or explicit skill selection
spatial-computing-builder	mutate · base	Operate as the spatial-computing builder with bounded mutations and verifier discipline.	spatial-computing work or explicit selection
spatial-computing-playbook	orchestrate · base	Operate as the spatial-computing specialist for this run.	spatial-computing work or explicit selection
spatial-computing-reviewer	read · base	Review spatial-computing outputs for accuracy, credibility, and completeness.	spatial-computing work or explicit selection
strategy-builder	orchestrate · base	Operate as the strategy builder with bounded mutations and verifier discipline.	strategy work or explicit selection
strategy-playbook	orchestrate · base	Operate as the strategy specialist for this run.	strategy work or explicit selection
strategy-reviewer	read · base	Review strategy outputs for accuracy, credibility, and completeness.	strategy work or explicit selection
support-builder	orchestrate · base	Operate as the support builder with bounded mutations and verifier discipline.	support work or explicit selection
support-playbook	orchestrate · base	Operate as the support specialist for this run.	support work or explicit selection
support-reviewer	read · base	Review support outputs for accuracy, credibility, and completeness.	support work or explicit selection
Tech Lead	read · base	🏛️ Tech Lead	runtime selection or explicit skill selection
testing-builder	orchestrate · base	Operate as the testing builder with bounded mutations and verifier discipline.	testing work or explicit selection
testing-playbook	orchestrate · base	Operate as the testing specialist for this run.	testing work or explicit selection
testing-reviewer	read · base	Review testing outputs for accuracy, credibility, and completeness.	testing work or explicit selection
Token Guardian	read · base	🪙 Token Guardian	runtime selection or explicit skill selection
Topic Indexer	read · base	🏷️ Topic Indexer	runtime selection or explicit skill selection
typescript-builder	mutate · base	Operate as the typescript builder with bounded mutations and verifier discipline.	typescript work or explicit selection
typescript-playbook	orchestrate · base	Operate as the typescript specialist for this run.	typescript work or explicit selection
typescript-reviewer	read · base	Review typescript outputs for accuracy, credibility, and completeness.	typescript work or explicit selection
UX Researcher	read · base	🎨 UX Researcher	deep-tech work or explicit selection
workflows-builder	orchestrate · base	Operate as the workflows builder with bounded mutations and verifier discipline.	workflows work or explicit selection
workflows-playbook	orchestrate · base	Operate as the workflows specialist for this run.	workflows work or explicit selection
workflows-reviewer	read · base	Review workflows outputs for accuracy, credibility, and completeness.	workflows work or explicit selection
writing-builder	orchestrate · base	Operate as the writing builder with bounded mutations and verifier discipline.	writing work or explicit selection
writing-playbook	orchestrate · base	Operate as the writing specialist for this run.	writing work or explicit selection
writing-reviewer	read · base	Review writing outputs for accuracy, credibility, and completeness.	writing work or explicit selection

Workflows (64)

Name	Type/Scope	Purpose	Trigger / When used
ai-approval-loop	workflow · base	Bundled ai approval loop with review, verification, and promotion control.	ai approval requested; ai promotion under review
ai-execution-loop	workflow · base	Bundled ai workflow with planning, execution, and verification checkpoints.	goal mentions ai; ai pack selected
api-approval-loop	workflow · base	Bundled api approval loop with review, verification, and promotion control.	api approval requested; api promotion under review
api-execution-loop	workflow · base	Bundled api workflow with planning, execution, and verification checkpoints.	goal mentions api; api pack selected
backend-approval-loop	workflow · base	Bundled backend approval loop with review, verification, and promotion control.	backend approval requested; backend promotion under review
backend-execution-loop	workflow · base	Bundled backend workflow with planning, execution, and verification checkpoints.	goal mentions backend; backend pack selected
data-approval-loop	workflow · base	Bundled data approval loop with review, verification, and promotion control.	data approval requested; data promotion under review
data-execution-loop	workflow · base	Bundled data workflow with planning, execution, and verification checkpoints.	goal mentions data; data pack selected
deep-tech-approval-loop	workflow · base	Bundled deep-tech approval loop with review, verification, and promotion control.	deep-tech approval requested; deep-tech promotion under review
deep-tech-execution-loop	workflow · base	Bundled deep-tech workflow with planning, execution, and verification checkpoints.	goal mentions deep-tech; deep-tech pack selected
deploy-prep	workflow · base	Pre-deployment review — verify everything is ready to ship	workflows execution or approval path
design-approval-loop	workflow · base	Bundled design approval loop with review, verification, and promotion control.	design approval requested; design promotion under review
design-execution-loop	workflow · base	Bundled design workflow with planning, execution, and verification checkpoints.	goal mentions design; design pack selected
django-approval-loop	workflow · base	Bundled django approval loop with review, verification, and promotion control.	django approval requested; django promotion under review
django-execution-loop	workflow · base	Bundled django workflow with planning, execution, and verification checkpoints.	goal mentions django; django pack selected
economics-approval-loop	workflow · base	Bundled economics approval loop with review, verification, and promotion control.	economics approval requested; economics promotion under review
economics-execution-loop	workflow · base	Bundled economics workflow with planning, execution, and verification checkpoints.	goal mentions economics; economics pack selected
finance-approval-loop	workflow · base	Bundled finance approval loop with review, verification, and promotion control.	finance approval requested; finance promotion under review
finance-execution-loop	workflow · base	Bundled finance workflow with planning, execution, and verification checkpoints.	goal mentions finance; finance pack selected
frontend-approval-loop	workflow · base	Bundled frontend approval loop with review, verification, and promotion control.	frontend approval requested; frontend promotion under review
frontend-execution-loop	workflow · base	Bundled frontend workflow with planning, execution, and verification checkpoints.	goal mentions frontend; frontend pack selected
full-audit	workflow · base	Run all agents end-to-end for a comprehensive project audit	workflows execution or approval path
game-development-approval-loop	workflow · base	Bundled game-development approval loop with review, verification, and promotion control.	game-development approval requested; game-development promotion under review
game-development-execution-loop	workflow · base	Bundled game-development workflow with planning, execution, and verification checkpoints.	goal mentions game-development; game-development pack selected
gtm-approval-loop	workflow · base	Bundled gtm approval loop with review, verification, and promotion control.	gtm approval requested; gtm promotion under review
gtm-execution-loop	workflow · base	Bundled gtm workflow with planning, execution, and verification checkpoints.	goal mentions gtm; gtm pack selected
integrations-approval-loop	workflow · base	Bundled integrations approval loop with review, verification, and promotion control.	integrations approval requested; integrations promotion under review
integrations-execution-loop	workflow · base	Bundled integrations workflow with planning, execution, and verification checkpoints.	goal mentions integrations; integrations pack selected
marketing-approval-loop	workflow · base	Bundled marketing approval loop with review, verification, and promotion control.	marketing approval requested; marketing promotion under review
marketing-execution-loop	workflow · base	Bundled marketing workflow with planning, execution, and verification checkpoints.	goal mentions marketing; marketing pack selected
node-approval-loop	workflow · base	Bundled node approval loop with review, verification, and promotion control.	node approval requested; node promotion under review
node-execution-loop	workflow · base	Bundled node workflow with planning, execution, and verification checkpoints.	goal mentions node; node pack selected
orchestration-approval-loop	workflow · base	Bundled orchestration approval loop with review, verification, and promotion control.	orchestration approval requested; orchestration promotion under review
orchestration-execution-loop	workflow · base	Bundled orchestration workflow with planning, execution, and verification checkpoints.	goal mentions orchestration; orchestration pack selected
paid-media-approval-loop	workflow · base	Bundled paid-media approval loop with review, verification, and promotion control.	paid-media approval requested; paid-media promotion under review
paid-media-execution-loop	workflow · base	Bundled paid-media workflow with planning, execution, and verification checkpoints.	goal mentions paid-media; paid-media pack selected
pdlc-approval-loop	workflow · base	Bundled pdlc approval loop with review, verification, and promotion control.	pdlc approval requested; pdlc promotion under review
pdlc-execution-loop	workflow · base	Bundled pdlc workflow with planning, execution, and verification checkpoints.	goal mentions pdlc; pdlc pack selected
product-approval-loop	workflow · base	Bundled product approval loop with review, verification, and promotion control.	product approval requested; product promotion under review
product-execution-loop	workflow · base	Bundled product workflow with planning, execution, and verification checkpoints.	goal mentions product; product pack selected
python-approval-loop	workflow · base	Bundled python approval loop with review, verification, and promotion control.	python approval requested; python promotion under review
python-execution-loop	workflow · base	Bundled python workflow with planning, execution, and verification checkpoints.	goal mentions python; python pack selected
quick-check	workflow · base	Fast health check — build, tests, and critical issues only	frontend execution or approval path
react-approval-loop	workflow · base	Bundled react approval loop with review, verification, and promotion control.	react approval requested; react promotion under review
react-execution-loop	workflow · base	Bundled react workflow with planning, execution, and verification checkpoints.	goal mentions react; react pack selected
sales-approval-loop	workflow · base	Bundled sales approval loop with review, verification, and promotion control.	sales approval requested; sales promotion under review
sales-execution-loop	workflow · base	Bundled sales workflow with planning, execution, and verification checkpoints.	goal mentions sales; sales pack selected
security-approval-loop	workflow · base	Bundled security approval loop with review, verification, and promotion control.	security approval requested; security promotion under review
security-execution-loop	workflow · base	Bundled security workflow with planning, execution, and verification checkpoints.	goal mentions security; security pack selected
session-close	workflow · base	End-of-session memory flush — persist all learnings	workflows execution or approval path
spatial-computing-approval-loop	workflow · base	Bundled spatial-computing approval loop with review, verification, and promotion control.	spatial-computing approval requested; spatial-computing promotion under review
spatial-computing-execution-loop	workflow · base	Bundled spatial-computing workflow with planning, execution, and verification checkpoints.	goal mentions spatial-computing; spatial-computing pack selected
strategy-approval-loop	workflow · base	Bundled strategy approval loop with review, verification, and promotion control.	strategy approval requested; strategy promotion under review
strategy-execution-loop	workflow · base	Bundled strategy workflow with planning, execution, and verification checkpoints.	goal mentions strategy; strategy pack selected
support-approval-loop	workflow · base	Bundled support approval loop with review, verification, and promotion control.	support approval requested; support promotion under review
support-execution-loop	workflow · base	Bundled support workflow with planning, execution, and verification checkpoints.	goal mentions support; support pack selected
testing-approval-loop	workflow · base	Bundled testing approval loop with review, verification, and promotion control.	testing approval requested; testing promotion under review
testing-execution-loop	workflow · base	Bundled testing workflow with planning, execution, and verification checkpoints.	goal mentions testing; testing pack selected
typescript-approval-loop	workflow · base	Bundled typescript approval loop with review, verification, and promotion control.	typescript approval requested; typescript promotion under review
typescript-execution-loop	workflow · base	Bundled typescript workflow with planning, execution, and verification checkpoints.	goal mentions typescript; typescript pack selected
workflows-approval-loop	workflow · base	Bundled workflows approval loop with review, verification, and promotion control.	workflows approval requested; workflows promotion under review
workflows-execution-loop	workflow · base	Bundled workflows workflow with planning, execution, and verification checkpoints.	goal mentions workflows; workflows pack selected
writing-approval-loop	workflow · base	Bundled writing approval loop with review, verification, and promotion control.	writing approval requested; writing promotion under review
writing-execution-loop	workflow · base	Bundled writing workflow with planning, execution, and verification checkpoints.	goal mentions writing; writing pack selected

Hooks (9)

Name	Type/Scope	Purpose	Trigger / When used
before-compaction-flush	read · base	Flush memory prefrontal to SQLite before context compaction.	before-compaction · context budget nearing limit
before-mutate-guard	read · base	Local checkpoint before bounded file mutation.	before-mutate
before-verify-approval	orchestrate · base	Attach approval-loop workflows before verification for domain work.	before-verify · verification checkpoint
failure-summary	read · base	Local failure checkpoint for recovery notes and retry scope.	run.failed
memory-shield-escalation	read · base	Flag stored memories for shield review when policy risk is detected.	memory.stored · high priority memory stored
memory-stored-review	read · base	Local review hook for important stored memories.	memory.stored
promotion-audit	read · base	Require a security-oriented audit note on promotion approval.	promotion.approved · promotion approved
retry-narrow-scope	orchestrate · base	Focus retries on the failing surface after an error cluster.	retry · retry requested
run-created-brief	read · base	Attach planning context and default orchestration on run creation.	run.created · run created

Automations (5)

Name	Type/Scope	Purpose	Trigger / When used
failure-followup	event · base	Queue a bounded retry follow-up after a failed run.	event:run.failed
failure-recovery-automation	event · base	Queue retry and review workflows after a failed run.	event:run.failed
memory-governance-automation	event · base	Attach memory and security review after memory storage events.	event:memory.stored
session-close-followup	event · base	Queue a bounded approval follow-up after a verified run.	event:run.verified
verified-followup-automation	event · base	Queue a bounded approval workflow after a verified run.	event:run.verified

Crews (7)

Name	Type/Scope	Purpose	Trigger / When used
Content Crew	crew template	Writing, storytelling, and distribution specialists for content and docs surfaces.	domains: writing, marketing · gates: pm, cto, marketer-docs
Finance Crew	crew template	Finance, analytics, and strategic review specialists for business and economics tasks.	domains: finance, economics, data · gates: pm, cto
GTM Crew	crew template	Launch, growth, messaging, and content specialists working from shipped capability.	domains: gtm, marketing, sales, writing · gates: pm, architecture, cto, marketer-docs
Implementation Crew	crew template	Execution-focused engineering crew with verifier and release safety.	domains: backend, frontend, typescript, node, python, django, react · gates: architecture, code-review, cto, devops
PDLC Crew	crew template	Sequential planning, implementation, QA, and shipping for product delivery.	domains: pdlc, product, backend, frontend · gates: pm, architecture, code-review, cto, devops, marketer-docs
Research Crew	crew template	Research, architecture, analysis, and evidence collection for uncertain tasks.	domains: deep-tech, research, ai · gates: pm, architecture, cto
Security Crew	crew template	Threat, trust, identity, and secure release specialists.	domains: security, trust, identity · gates: architecture, code-review, cto, devops

📜 Release History

v3.18.0 · 2026-03-21 · Lifecycle hardening across MCP, bootstrap artifacts, and release surfaces

• Lifecycle checklists and footers: nexus_session_bootstrap now appends a mandatory protocol checklist, and nexus_orchestrate now appends a mandatory remaining-steps footer.
• Lifecycle warnings: MCP responses now warn when 15+ post-orchestrate tool calls happen without nexus_store_memory, and when Nexus-visible 3+ file intent appears without nexus_optimize_tokens.
• Shared instruction closure: CLAUDE.md, AGENTS.md, client bootstrap artifacts, and the feature registry now agree that nexus_orchestrate does not replace during-work or end-of-session lifecycle steps.
• Release-surface alignment: Protocol, integrations, knowledge-base, README, and generated bootstrap surfaces now use the same mandatory lifecycle wording.

Full notes: releases/v3.18.0.md · Full history: CHANGELOG.md

v3.17.0 · 2026-03-20 · Agent adoption hardening, memory readability, atlas code intelligence peer

• Hard bootstrap enforcement: Non-bootstrap MCP tool calls return a structured blocked response with next-step guidance instead of a soft warning agents ignored. Read-only tools remain exempt.
• Atlas code intelligence peer: Auto-detects Atlas (AST parsing, semantic search, impact analysis) and writes MCP config for all clients when available.
• Memory readability: Fixed text overflow on memory cards/timeline, default-filtered phantom and quarantine noise from dashboard, added phantom toggle.
• Imperative tool descriptions: Rewrote MCP tool descriptions from "Preferred" to "REQUIRED" and planning nudges from "consider" to "Next: call".
• Streamlined CLAUDE.md: 134-line protocol manual → 16-line imperative instruction set. Full protocol moved to docs/nexus-protocol.md.

Full notes: CHANGELOG.md

v3.16.0 · 2026-03-20 · Compaction sentinel, tiered context, token analytics, peer federation, installation hardening

• Compaction Sentinel + Tiered Context: Pre-compaction memory flush and L0/L1/L2 progressive file loading.
• Token Analytics: Lifetime optimization reporting with per-session breakdowns, persisted in SQLite.
• Self-Learning Skills + Repo Tree: Automatic skill derivation and cached repo tree visualization.
• Peer Connectors: Auto-detect and sync with OpenClaw, Hermes, PicoClaw peers.
• Installation Hardening: XDG-aware config, path validation, install logging, nexus-prime setup diagnose, 12 client targets.
• Multi-Intent Classification: Orchestrator scores all intents, surfaces secondary when within 80% of primary.

Full notes: CHANGELOG.md

v3.14.0 · 2026-03-16 · Ollama/HuggingFace embeddings, autonomous memory, agent ecosystem expansion

• Embedding backend chain: Added Ollama and HuggingFace Inference API as embedding backends with automatic fallback (Ollama → HuggingFace → OpenAI → Local TF-IDF).
• Agent ecosystem expansion: Added first-class setup for Aider, Continue.dev, and Cline alongside existing Codex, Cursor, Claude Code, Opencode, Windsurf, and OpenClaw adapters (9 agents total).
• OpenClaw memory bridge: Bidirectional memory sync between Nexus Prime and OpenClaw instances via nexus_openclaw_memory_sync.
• Autonomous memory management: Configurable decay rates, access-frequency retention (frequently recalled memories decay slower), and a maintenance cycle that expires stale low-value memories.
• Learning-to-skill promotion: Recurring agent learnings are automatically promoted to reusable skills when access patterns indicate reliability.
• Fuzzy skill matching: Skill resolution now uses Jaccard similarity scoring instead of exact name matching, so approximate goal text finds relevant skills.
• Adaptive token optimization: Reading plan thresholds adjust dynamically based on file count and budget constraints.
• Docker one-click install: docker compose up starts Nexus Prime; --profile with-ollama adds local Ollama for fully offline operation.
• Hardened graph containment: Memory Explorer graph nodes now stay strictly inside the graph viewport via contain: paint, SVG overflow clipping, viewBox-aware position clamping, and tighter ring radii — fully eliminates the overlap with Memory Health/Scope text below.
• Stronger orchestrator adoption: Instruction gateway and project rules now use imperative MUST/NEVER phrasing so coding agents proactively route through nexus_session_bootstrap and nexus_orchestrate instead of falling back to manual file exploration.
• Fixed: Claude Code MCP config path corrected to ~/.claude/mcp.json. Agent auto-config now writes workspace configs during npm install.

Full notes: CHANGELOG.md

v3.13.0 · 2026-03-15 · Workspace surfaces, dashboard layout fixes, and community presence

• Dashboard workspaces now drive their own graph visibility, library tabs, titles, and subtitles per surface mode (overview, knowledge, runs, catalog, governance).
• Fixed memory graph overlapping text in non-graph surfaces by collapsing focusable-shell gap when the graph widget is hidden and removing conflicting inline margin.
• Added graph-note text overflow handling and responsive min-height for hidden-graph surfaces.
• Library tabs are now rendered dynamically per workspace instead of a single hardcoded rail.
• Knowledge workspace auto-opens the create form when no collections exist.
• Plan and execute actions now switch to the runs workspace automatically.
• Added community badges (Reddit, Discord), engagement badges (stars, forks, issues, PRs), and the r/LLMDevs #1 Post of the Day recognition.

Full notes: CHANGELOG.md

v3.12.1 · 2026-03-14 · Dashboard focus mode, graph recall wiring, and bootstrap recovery

• Added dashboard maximize/restore focus mode across the main operational panels so graph, memory snapshots, runtime events, and operator actions are usable without the cramped default layout.
• Wired graph memory into the main recall path, auto-seeded first-run RAG collections from bounded project context, and rehydrated dashboard event history from persisted logs.
• Tightened the cockpit density, clarified the RAG injection path, rotated persisted events, and seeded visible local hook/automation starters for fresh workspaces.

Full notes: releases/v3.12.1.md · Full history: CHANGELOG.md

v3.12.0 · 2026-03-14 · Public surface, proof screenshots, and release visibility

• Rebuilt the README hierarchy around what Nexus Prime is, why it is different, the bootstrap-orchestrate path, and proof-backed capabilities.
• Replaced repeated landing-page imagery with a graph-first hero, a distinct runtime-sequence proof image, and clearer knowledge-trace placement.
• Expanded the generated inventory surfaces so README, docs, and dashboard all show counts for skills, workflows, hooks, automations, crews, specialists, MCP surfaces, client targets, dashboard capabilities, runtime subsystems, and release gates.
• Converted the changelog to version-level toggle history and prepared the v3.12.0 release draft for GitHub release publication and npm publish.

Full notes: releases/v3.12.0.md · Full history: CHANGELOG.md

📈 Star History

License: MIT
Maintainer: Adarsh Agrahari (sir-ad)