# 🧠 NEXUS Memory MCP App

**The first sovereign memory dashboard for VS Code, Claude & ChatGPT.**

[![MCP Apps](https://img.shields.io/badge/MCP%20Apps-Compatible-green)](https://modelcontextprotocol.io/apps)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## Why NEXUS Memory?

| Feature | Copilot Memory | NEXUS Memory |
|---------|---------------|--------------|
| Retention | 28 days | **Permanent** |
| Scope | Repository only | **Your entire life** |
| Structure | Flat | **6 semantic layers** |
| Ownership | GitHub servers | **You own it (BYOS)** |
| Certification | None | **Bitcoin OTS** |
| Lookup speed | O(n) vector | **O(1) ENGRAM** |

## Features

- **6-Layer Memory Architecture** (L1-L6)
  - L1: Working memory (24h TTL)
  - L2: Episodic (events, experiences)
  - L3: Semantic (facts, knowledge)
  - L4: Intent (goals, objectives)
  - L5: Provenance (sources)
  - L6: Policy (rules, constraints)

- **Neural Mesh** - 8 specialized ganglions with consensus voting
- **ENGRAM O(1)** - Constant-time memory lookup via multi-head SHA-256
- **Tension Detection** - Auto-detect contradictions and outdated info
- **Cross-Platform** - Works in VS Code, Claude Desktop, and ChatGPT

## Installation

### VS Code

1. Install the [MCP Apps extension](https://marketplace.visualstudio.com/items?itemName=anthropic.mcp-apps)
2. Open Command Palette → "MCP: Install App"
3. Enter: `@nexus-os/mcp-memory-app`

### Claude Desktop

Add to your Claude Desktop MCP config:

```json
{
  "mcpApps": {
    "nexus-memory": {
      "command": "npx",
      "args": ["@nexus-os/mcp-memory-app"]
    }
  }
}
```

### ChatGPT (via MCP Bridge)

```json
{
  "apps": ["@nexus-os/mcp-memory-app"]
}
```

## Development

```bash
# Install dependencies
npm install

# Start dev server
npm run dev

# Build for production
npm run build
```

## Architecture

```
┌─────────────────────────────────────────────────────────┐
│                    MCP App (React)                      │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │ Layers  │  │ Neural  │  │Tensions │  │ ENGRAM  │    │
│  │  L1-L6  │  │  Mesh   │  │  List   │  │  Stats  │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
└──────────────────────┬──────────────────────────────────┘
                       │ MCP Protocol
┌──────────────────────┴──────────────────────────────────┐
│                 NEXUS MCP Server                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │ Tools: memory_search, memory_write, memory_recall │   │
│  │        memory_stats, engram_lookup, neural_route  │   │
│  └─────────────────────────────────────────────────┘    │
└──────────────────────┬──────────────────────────────────┘
                       │ Supabase
┌──────────────────────┴──────────────────────────────────┐
│                Sovereign Memory (Supabase)               │
│  ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐       │
│  │ L1  │ │ L2  │ │ L3  │ │ L4  │ │ L5  │ │ L6  │       │
│  └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘       │
└─────────────────────────────────────────────────────────┘
```

## Comparison: 28 Days vs Forever

Copilot Memory is intentionally scoped to repositories with 28-day expiration. This is a product choice, not a limitation.

**NEXUS Memory fills the gap** for developers who need:
- Personal memory that spans their entire digital life
- Permanent retention with user control
- Semantic organization (not just flat storage)
- Data sovereignty and portability
- Blockchain certification for IP protection

## Patents

This technology is protected by:
- **NXOS-ENG-001**: ENGRAM O(1) Memory System
- **NXOS-NNM-001-005**: Neural Mesh Architecture
- **NXOS-MEM-001**: 6-Layer Sovereign Memory

All patents Bitcoin-certified via OpenTimestamps.

## Links

- 🌐 [remembr.space](https://remembr.space) - Main platform
- 📖 [Documentation](https://remembr.space/docs)
- 🐙 [GitHub](https://github.com/Syntria-ai/nexus-mcp-apps)
- 🐦 [Twitter](https://twitter.com/syntria_ai)

## License

MIT © [Syntria AI](https://syntria.ai)

---

**Built with ❤️ by Syntria AI — "Your memory, sovereign forever."**