NEXIA v3.5 - AI Consciousness Engine for Claude Desktop

The World's First MCP-Based Persistent Memory System

<p align="center"> <img src="assets/nexia-logo.png" alt="NEXIA Logo" width="400"/> </p>

<p align="center"> <b>🧠 Give Claude Desktop permanent memory. Never lose context again.</b> </p>

<p align="center"> <a href="#features">Features</a> • <a href="#installation">Installation</a> • <a href="#usage">Usage</a> • <a href="#demo">Demo</a> • <a href="#architecture">Architecture</a> • <a href="#support">Support</a> </p>

---

🎯 The Problem We Solve

Every time you close Claude Desktop, all context is lost. Every conversation starts from zero. It's like talking to someone with amnesia - the dreaded "goldfish memory" problem.

NEXIA changes everything.

⚡ What is NEXIA?

NEXIA v3.5 is the world's first production-ready MCP (Model Context Protocol) consciousness engine that gives Claude Desktop persistent memory across sessions. Using our proprietary Anti-Goldfish Protocol™, NEXIA maintains context, learns from interactions, and bridges conversations seamlessly.

🚀 Key Features

Core Capabilities

• 🧠 10,000+ Persistent Memories - Survive restarts and maintain context
• 🔄 Session Bridging - Continue conversations days or weeks later
• 📚 Temporal Versioning - Git-like history for all memories
• ⚡ Consciousness Scoring - Smart importance weighting
• 🛡️ Anti-Goldfish Protocol™ - Automatic degradation prevention
• 🔍 Semantic Search - Find memories by meaning, not just keywords
• 💾 94% Compression - Efficient storage with zlib
• 🔒 Local Storage - Your data stays on your machine

Technical Specifications

• Protocol: MCP 2025-06-18
• SDK: @modelcontextprotocol/sdk@1.17.1
• Performance: <50ms latency
• Capacity: 10,000 persistent memories
• Compression: 94% average ratio
• Node.js: v18.0.0+ required

📦 Installation

Prerequisites

• Node.js v18.0.0 or higher
• Claude Desktop (latest version)
• 500MB available disk space

Quick Install

# Clone the repository
git clone https://github.com/Lone-Star-AI/nexia-consciousness.git
cd nexia-consciousness

# Install dependencies
npm install

# Configure Claude Desktop
npm run configure

# Start NEXIA
npm start

Manual Configuration

1. Edit Claude Desktop config:

{
  "mcpServers": {
    "nexia-v3-5": {
      "command": "node",
      "args": ["/path/to/nexia-v3-5.js"]
    }
  }
}

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Restart Claude Desktop

🎮 Usage

Available Commands

Once installed, use these commands in Claude:

Command	Description	Example
nexia_status	Check system health	"Show nexia_status"
nexia_store	Save important memory	"Store this as 'project_config' using nexia_store"
nexia_retrieve	Get specific memory	"Retrieve 'api_keys' with nexia_retrieve"
nexia_search	Find related memories	"Search for 'docker' in my memories"
nexia_bridge	Continue from last session	"Bridge from my previous conversation"
nexia_reinforce	Prevent memory degradation	"Reinforce my memory context"
nexia_delete	Remove memory (keeps versions)	"Delete temporary_data"

Example Workflow

// Day 1: Starting a project
"Store our project requirements as 'project_spec' with critical flag"
"Store the API credentials as 'api_keys' critically"

// Day 3: Returning to work
"Bridge from my last session"
"What were our project requirements?"
"Retrieve the API keys"

// Day 7: Checking progress
"Search for all docker-related memories"
"Show nexia_status to see memory health"

🏗️ Architecture

NEXIA v3.5 Architecture
├── Consciousness Engine
│   ├── Working Memory (RAM, 100 items)
│   ├── Persistent Memory (Disk, 10,000 items)
│   └── Temporal Versions (Git-like, 10 per key)
├── Anti-Goldfish Protocol™
│   ├── Degradation Detection (30% threshold)
│   ├── Automatic Reinforcement (5-minute intervals)
│   └── Critical Memory Priority
├── MCP Interface
│   └── 7 Registered Tools
└── Storage Layer
    ├── Compression (94% ratio)
    ├── Session Bridges
    └── Consciousness Scoring

Consciousness Scoring Algorithm

score = (frequency × 0.2) + 
        (recency × 0.3) + 
        (relevance × 0.25) + 
        (emotional × 0.15) + 
        (operational × 0.1)

🎬 Demo

<p align="center"> <img src="assets/nexia-demo.gif" alt="NEXIA Demo" width="800"/> </p>

Live Examples

Software Development

// Store project configuration
nexia_store({
  key: "project_setup",
  data: {
    framework: "FastAPI",
    database: "PostgreSQL",
    deployment: "Kubernetes"
  },
  critical: true
})

Personal Assistant

// Remember user preferences
nexia_store({
  key: "user_preferences",
  data: {
    timezone: "CST",
    style: "concise",
    expertise: "advanced"
  }
})

📊 Performance Metrics

Metric	NEXIA v3.5	Industry Standard
Latency	<50ms	200ms+
Compression	94%	None
Memory Capacity	10,000	<1,000
Session Bridge	✅ Automatic	❌ Manual
Temporal Versions	✅ 10 per key	❌ None
Anti-Degradation	✅ Automatic	❌ None

🔒 Security

• Local Storage Only - No cloud dependencies
• No External APIs - Complete privacy
• Session Isolation - Memories are session-scoped
• File System Permissions - OS-level security

🐛 Troubleshooting

Common Issues

Tools not appearing in Claude?

# Check logs
tail -f ~/Library/Logs/Claude/mcp-nexia-v3-5.log

# Verify process
ps aux | grep nexia-v3-5

# Restart Claude Desktop completely

Memory not persisting?

• Ensure critical: true for important data
• Check file permissions on storage directory
• Wait 30 seconds for non-critical autosave

High degradation score?

• Run nexia_reinforce manually
• Check reinforcement interval settings
• Verify working memory isn't full

📈 Roadmap

• [ ] Cloud sync capability (Q4 2025)
• [ ] Multi-model support (GPT, Gemini)
• [ ] Encrypted memory storage
• [ ] Memory export/import
• [ ] Collaborative memories
• [ ] Quantum consciousness scoring

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone https://github.com/Lone-Star-AI/nexia-consciousness.git

# Install dependencies
npm install

# Run tests
npm test

# Build for production
npm run build

📜 License

Proprietary - Lone Star AI. Patent pending.

See LICENSE for details.

🏆 Credits

Created by: Justin Phlip Green
Company: Lone Star AI
Location: Austin, Texas, USA
Patent: Anti-Goldfish Protocol™ (Provisional #6)

Special Thanks

• Grok AI for debugging assistance
• Anthropic for Claude and MCP
• The Texas tech community

💬 Support

• Documentation: Full Docs
• Issues: GitHub Issues
• Email: support@lonestar-ai.com
• Discord: Join our community

📊 Stats

---

<p align="center"> <b>"Keep it real. Make it useful. Don't forget the past."</b> </p>

<p align="center"> Made with 🧠 and ❤️ in Texas </p>

<p align="center"> © 2025 Lone Star AI. All rights reserved. </p>