cdeust/Cortex

22 stars · Last commit 2026-04-26

Persistent memory for Claude Code — 41 neuroscience papers, 20 biological mechanisms. 97.8% R@10 LongMemEval | 92.6% R@10 LoCoMo | +33.4% BEAM-10M over flat retrieval (0.471 vs 0.353). Stage-Aware Context Assembly. PostgreSQL + pgvector.

README preview

<p align="center">
  <img src="docs/assets/cortex-workflow-graph.png" alt="Cortex workflow graph — each project becomes a dense brain-region cloud whose shape IS its code: files, commands, agents, memories and AST symbols (functions, methods, classes, modules, constants across 10 languages) are pulled into position by the real edges between them (defined_in, calls, imports, member_of, tool_used_file). Symbols touched by two projects sit in the inter-project space between their hubs; long threads mark shared files and MCPs." width="100%"/>
</p>

<p align="center">
  <a href="https://github.com/cdeust/Cortex/actions/workflows/ci.yml"><img src="https://github.com/cdeust/Cortex/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
  <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+">
  <img src="https://img.shields.io/badge/tests-2500_passing-brightgreen.svg" alt="Tests">
  <img src="https://img.shields.io/badge/citations-41_papers-orange.svg" alt="Citations">
  <img src="https://img.shields.io/badge/version-3.14.2-brightgreen.svg" alt="Version 3.14.2">
  <a href="https://glama.ai/mcp/servers/cdeust/Cortex"><img src="https://glama.ai/mcp/servers/cdeust/Cortex/badges/score.svg" alt="Glama score: security A, license A"></a>
</p>

<p align="center">
  <a href="#getting-started">Getting Started</a> · <a href="#write-papers-in-cortex">Write Papers</a> · <a href="#what-this-actually-feels-like">What It Feels Like</a> · <a href="#retrieval-that-actually-works">Benchmarks</a> · <a href="#the-science-under-the-hood">Science</a> · <a href="#neural-graph">Views</a>
</p>

<p align="center">
  <strong>Companion projects:</strong><br>

View full repository on GitHub →