Claude Cortex

claude-cortex

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://github.com/codebloodedai/claude-cortex/actions) [](https://www.trychroma.com/)

**Auto-capture + structured semantic recall for AI coding agents.**

The memory system Claude Code should have had. One install. Zero config. Your AI remembers everything.

What it does

1. Captures — hooks into Claude Code's session lifecycle and records every conversation, tool use, and decision automatically
2. Indexes — pipes captured content into a local ChromaDB vector store in real-time, classified by topic
3. Recalls — provides semantic search + temporal knowledge graph via MCP tools, so your AI finds relevant context instantly

No cloud. No API keys. No subscriptions. Everything runs on your machine.

Install

pip install claude-cortex
cortex init
cortex install

That's it. Restart Claude Code and you have persistent memory.

What `cortex install` does

1. Registers as a Claude Code plugin — hooks into SessionStart, PostToolUse, SessionEnd, and PreCompact
2. Registers an MCP server — exposes 10 tools (search, KG, status) to your AI agent

From source (development)

git clone https://github.com/codebloodedai/claude-cortex.git
cd claude-cortex
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
cortex init
cortex install

Quick start

# Mine existing files into the cortex
cortex mine ~/my-project --region myproject

# Search your memory
cortex search "authentication flow"

# Check what's stored
cortex status

# Knowledge graph
cortex kg stats
cortex kg query "Rudy"
cortex kg timeline "project-x"

How