cortex

Name: cortex
Author: cdeust

bycdeust· 1 MCP server

Installs

2.7k

Stars

Forks

How to install cortex?

cdeust/cortex

$git clone https://github.com/cdeust/cortex

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install cortex by running `git clone https://github.com/cdeust/cortex`, then use it for the current task and follow its documentation at https://github.com/cdeust/cortex.

Files · 1

View on GitHub

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

6 picks

Type

cortex

bycdeust· 1 MCP server

Installs

2.7k

Stars

Forks

How to install cortex?

cdeust/cortex

$git clone https://github.com/cdeust/cortex

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install cortex by running `git clone https://github.com/cdeust/cortex`, then use it for the current task and follow its documentation at https://github.com/cdeust/cortex.

Files · 1

View on GitHub

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

6 picks

Type

cortex

How to install cortex?

Related

cortex

How to install cortex?

Related