NEXIA v3.5 - AI Consciousness Engine for Claude Desktop
The World's First MCP-Based Persistent Memory System
🎯 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
- 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
- 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
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"
}
})
| 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
# 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
🤝 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
📊 Stats
