Cortex
installs/mo · pypistarsforks
How to install Cortex?
cdeust/cortex
$git clone https://github.com/cdeust/CortexPersistent memory for Claude Code built on computational neuroscience, not just retrieval. 36 cited brain mechanisms consolidate what matters, keep it current as your project evolves, and reconstruct the right context at the right time — a living memory, not a flat RAG. Says "I don't know" when unsure, flags contradictions. Local-first · MCP · MIT.
README.md
| 1 | <!-- mcp-name: io.github.cdeust/hypermnesia-mcp --> |
| 2 | |
| 3 | <p align="center"> |
| 4 | <img src="assets/banner.svg" alt="Cortex — persistent memory for Claude Code" width="820"> |
| 5 | </p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <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> |
| 9 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a> |
| 10 | <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+"> |
| 11 | <img src="https://img.shields.io/badge/tests-3000+_passing-brightgreen.svg" alt="Tests"> |
| 12 | <img src="https://img.shields.io/badge/references-97_papers-orange.svg" alt="References"> |
| 13 | <img src="https://img.shields.io/badge/version-4.13.1-brightgreen.svg" alt="Version 4.13.1"> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"> |
| 17 | <strong>Persistent memory for Claude Code built on computational neuroscience — not just retrieval.</strong> 36 cited brain mechanisms consolidate what matters, keep it current as your project evolves, and reconstruct the right context at the right time — a living memory, not a flat RAG. Says "I don't know" when unsure, flags its own contradictions. Local-first, single-click MCP install. |
| 18 | </p> |
| 19 | |
| 20 | <p align="center"> |
| 21 | <a href="#getting-started">Getting Started</a> · <a href="#configuration">Configuration</a> · <a href="#examples">Examples</a> · <a href="#whats-new">What's New</a> · <a href="#the-science-under-the-hood">Science</a> · <a href="#retrieval-that-actually-works">Benchmarks</a> · <a href="#the-autonomous-wiki">Wiki</a> · <a href="#architecture">Architecture</a> |
| 22 | </p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <strong>Companion projects:</strong><br> |
| 26 | <a href="https://github.com/cdeust/cortex-know-when-to-stop-training-model">cortex-beam-abstain</a> (repo <code>cortex-know-when-to-stop-training-model</code>) — community-trained retrieval abstention model for RAG systems<br> |
| 27 | <a href="https://github.com/cdeust/zetetic-team-subagents">zetetic-team-subagents</a> — specialist Claude Code agents Cortex orchestrates with<br> |
| 28 | <a href="https://github.com/cdeust/automatised-pipeline">automatised-pipeline</a> — automated 11-stage pipeline (findings → PRs); Cortex ingests its codebase analysis via the optional <code>ingest_codebase</code> / <code>change_impact</code> tools<br> |
| 29 | <a href="https://github.com/cdeust/cortex-viz">cortex-viz</a> — read-only visualization MCP (galaxy graph, execution trace, wiki browser) over the same store |
| 30 | </p> |
| 31 | |
| 32 | <p align="center"> |
| 33 | <sub><em><strong>Independent project:</strong> Cortex is an independent, open-source project. It is <strong>not an Anthropic product</strong> and is not affiliated with, sponsored by, or endorsed by Anthropic.</em></sub> |
| 34 | </p> |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | Claude forgets you every time you close the tab. Every architecture decision you explained. Every debugging session where you traced a bug through four layers of abstraction. Every "remember, we decided to use event sourcing, not CRUD" correction. Gone. Next session, you're a stranger to your own tools. |
| 39 | |
| 40 | Cortex is a persistent memory engine for Claude built on computational neuroscience. It remembers what you worked on, how you think, what you decided and why — not as a text dump shoved into context, but as a living memory system that consolidates, forgets intelligently, and reconstructs the right context at the right time. |
| 41 | |
| 42 | It runs **entirely on your machine** — a local SQLite database by default (zero setup, no services to install), or PostgreSQL + pgvector when you want it. A 22 MB embedding model, no LLM in the retrieval loop, no data leaving localhost. |
| 43 | |
| 44 | > **36 neuroscience mechanisms · 50 memory tools · 9 lifecycle hooks · a self-curating, continuously-groomed per-project wiki — all local, all open-source.** |
| 45 | |
| 46 | --- |
| 47 | |
| 48 | ## Getting Started |
| 49 | |
| 50 | Cortex ships as a single-click MCP bundle (`.mcpb`). Download the latest **`hypermnesia-mcp.mcpb`** from [Releases](https://github.com/cdeust/Cortex/releases), then open it in Claude Desktop — **Settings → Extensions** installs it in one click. |
| 51 | |
| 52 | It runs immediately on the built-in **SQLite backend**: zero configuration, no database to provision, nothing to set up. Memory persists to a local file under `~/.claude/methodology/`. That's the whole install. |
| 53 | |
| 54 | **Claude Cowork** works the same zero-setup way: the sandboxed environment is detected automatically (`CLAUDE_ENVIRONMENT=cowork`) and Cortex uses the local SQLite store — no PostgreSQL required. |
| 55 | |
| 56 | Want PostgreSQL + pgvector instead (for very large stores or a shared team database)? It's a single configuration field — see [Configuration](#configuration) below. SQLite is the default; PostgreSQL is opt-in. |
| 57 | |
| 58 | **Claude Code plugin (marketplace):** |
| 59 | ```bash |
| 60 | claude plugin marketplace add cdeust/Cortex |
| 61 | claude plugin install cortex |
| 62 | ``` |
| 63 | That is the whole install — zero configuration, no PostgreSQL, no system packages. The postInstall provisions Python dependencies and selects the local **SQLite** store (`~/.claude/methodology/memory.db`); the sto |
People who liked this also viewed
6 picksType
- fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 2025
- lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 2026
- rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026
- FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026
- repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026
- mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026
