Cnexus Cognitive Core

SKILL.md

---
name: cnexus-cognitive-core
description: >-
  CNexus 2.0 — The Geek's Digital Second Brain:
  Cognitive Architecture & Living Neural Metabolism.
  A living digital organism running locally with spreading activation,
  REM sleep metabolism, wormhole protocol, and AST code projection.
---

# CNexus 2.0 — The Geek's Digital Second Brain: Cognitive Architecture & Living Neural Metabolism

**GitHub/OpenClawHUB Repository:** [To be filled]

---

## Overview

CNexus 2.0 is not just another RAG (Retrieval-Augmented Generation) tool; it is a **living digital organism** running locally.

The goal of this project is to build a local "second brain" based on Cognitive Science. By breaking free from the limitations of static indexing, CNexus 2.0 introduces **dynamic neural spreading activation** and **REM sleep metabolism**, enabling the AI not only to "remember" every technical detail but to evolve alongside your cognitive patterns, achieving cross-dimensional resonance through its unique "**Wormhole Protocol**."

---

## Key Features

### 🧠 Living Cognitive Architecture

**Spreading Activation:** Forget traditional full-text searching. The system simulates real-time neural firing. High-frequency conversation topics are automatically "warmed up" in the subconscious, enabling millisecond-level precise context injection.

**REM Sleep Metabolism:** An automated self-cleansing and compression protocol. During idle periods, the system performs synaptic pruning (deleting junk data) and knowledge consolidation (distilling fragmented chats into long-term semantic bone nodes), ensuring the brain never suffers from bloat.

### 🌉 Cross-Dimensional Wormhole Protocol

**Local Cosine Wormholes:** Leveraging local vector spaces, this allows memory nodes that are physically disconnected to establish "wormholes" based on semantic similarity. Even if you haven't explicitly linked two concepts, the system can associate them instantly across the cognitive space.

### 🧬 Multimodal Physical Skeleton Perception

**AST Rapid Projection:** Zero-dependency parsing of Python codebases, weaving class definitions and inheritance relationships into a dynamic, neon-glowing network in real-time.

**Multimodal Architecture Recognition:** Through local visual models, the system automatically distills architecture diagrams into structured nodes, aligning your system design visuals with your conversational memory.

### ⚙️ Tech Stack

**Zero-Dependency Design:** Leveraging Python standard libraries (e.g., `ast`) to minimize reliance on heavy third-party vector databases, ensuring maximum sovereignty and portability.

**Hybrid Cloud-Edge Protocol:** Supports offline Ollama computing with an intelligent fallback logic for cloud-based Embedding APIs, guaranteeing seamless operation across varying hardware environments.

**Observability:** Exposes full `/api/status` and `/api/status/graph` endpoints, allowing users to monitor the "heartbeat" and "metabolism" of their neural network in real-time.

---

## Why CNexus 2.0?

If you are tired of generic tools that provide mechanical responses, suffer from memory bloat, or tend to "forget," CNexus 2.0 invites you into a new dimension. Here, your knowledge base is not just a storage unit; it is a **mirror of your thinking** and an **evolving companion**.

---

## Installation & Launch

```bash
# Launch the CNexus Core Engine
python app_v2.py --port 7864
```

## 📡 API Endpoints

| Endpoint | Description |
|---|---|
| `POST /api/converse` | Cognitive loop — distill interaction |
| `GET /api/status` | System state + memory graph |
| `GET /api/status/graph` | Neural network heartbeat & metabolism |
| `GET /v1/kernel/record/{trace_id}` | Full execution trace replay |

## 🔗 Links

- **GitHub:** [https://github.com/plusunm/CNexus2.0](https://github.com/plusunm/CNexus2.0)
- **Runtime:** `http://127.0.0.1:7865` (default)
- **Tech Stack:** Python + TypeScript/React + Canvas 2D + Local LLMs (Ollama)

---

> **CNexus 2.0 — Sovereign Control, Living Metabolism, Perceiving the Skeleton of Your Thoughts.**