🧠 Cortex OS
The Biological AI Memory Engine
npx -y github:robertogogoni/cortex-claude
A local, persistent memory storage system for Claude.
Features zero-shot vector mapping, an interactive terminal dashboard, Obsidian integration, and automatic event logging.
⚡ Quick Start • 💻 Usage • 🔌 API Reference • 🧬 Architecture
⚡ Tutorials: Quick Start
1. Global Installation
Launch the environment and run the Terminal Dashboard instantly using a zero-install prompt:
npx -y github:robertogogoni/cortex-claude
(This automatically clones into a secure cache context, executes the setup wizard, checks for your API Keys, and boots the local dashboard!)
2. Launch TUI Dashboard
Pull up the interface directly from the terminal globally.
cortex-tui
💻 How-To: Interactive CLI
The Cortex CLI enables absolute graphical, highly-responsive offline systems maintenance over your mapped cognitive layers. From here, you possess absolute read/write supremacy over your nodes.
🔍 Query Engine – Invoke Hybrid-Search executing reciprocal rank fusions combining dense vectorized data to pinpoint semantic facts.🎤 Ingest Data – Deposit hard data, voice logs, and syntax directly into the network.📁 Build Vault – Rip your biological network locally into an Obsidian environment mapping.🧠 Node Migration – Clean up rogue, legacy, or fragmented directories assigning them topographical positions.
🔌 Reference: API Specs & Key Systems
Cortex is architecturally abstracted extending its network over standard Web API sockets to assist 3rd Party HUD developments and multi-agent coordination. Boot npm run cortex locally to bind port :4000.
Query Route:
curl -X POST http://localhost:4000/api/query \
-H "Content-Type: application/json" \
-d '{"prompt": "How did I deploy the AWS bucket?", "domain": "engineering"}'
Core Execution Matrix
| Feature Layer | Core Execution Engine | Operations Detail |
|---|
| Biological Algorithms | claude-3-5-sonnet | Translates raw text boundaries into highly precise biomechanical arrays with limits, weights, and node routing algorithms. |
| Local Whisper Pipeline | @xenova/transformers | Off-grid speech-to-text pipeline utilizing lightweight transformer models for highly secure, multi-modal audio captures. |
| Dashboard Interface | @inquirer/prompts | Terminal-UI (TUI) allowing offline audit querying, data ingesting, explicit memory migrations, and hardware back-ups. |
| Obsidian Integration | Vanilla Javascript | Translates topographical memories dynamically into localized markdown layouts complete with styling and bi-directional indexing. |
🧬 Explanation: Neural Topography
AI agents traditionally suffer from context-window amnesia. They forget prior sessions, decisions, and idioms the moment a session ends. Cortex OS resolves this entirely.
Cortex automatically monitors your terminal sessions, ingests multi-modal data (text & audio), computes structural relevance using claude-3-5-sonnet, and stores knowledge into a fully searchable vector database mapping cleanly into an Obsidian Vault.
It organizes memory using hierarchical data structures rather than flat logs:
[Lobe] — The highest structural group (e.g., Engineering, Prefrontal, Temporal).[Region] — The operational domain classification (e.g., Data Processing, UX Design).[Cluster] — The synaptic target containing isolated, immutable atomic context.
C4 Container Architecture
C4Container
title System Context diagram for Cortex OS
