Cortexthe pre-frontal cortex for your codebase

Every codebase is a landscape of decisions, most of them invisible. The trade-offs that shaped the architecture, the alternatives that were considered and rejected, the constraints that pushed toward this design and away from another — all of it sits beneath the code, where no git blame can find it.

Cortex is a knowledge graph that captures decisions as they're made and lets agents query them later. Built as an MCP server and Claude Code plugin — a graph at rest, two-dimensional frames in motion.

Status
v1.5.1 · current
15+ MCP tools · 4 skills · 2 hooks
§ 02How Cortex thinks

Provenance is geological.

Every line of code sits on a stack of earlier decisions. Cortex preserves the strata so you — or an agent acting on your behalf — can read down through them when you need to understand why.

+0.0 HEAD−1.4 v1.4.0−3.7 v1.1.0−6.2 v0.6.0−9.8 initialWHY 04 / auth refactor
Fig. 01 — A repository's history rendered as cross-section. The drill-core marks a single line of inquiry; deeper strata are older decisions, still accessible.
cortex / strata model
§ 03Principles

Three commitments,
held loudly.

01

Capture in the moment.

Decisions evaporate fast. Cortex hooks into Claude Code so reasoning is recorded as it's spoken — not reconstructed from a commit message six months later.

02

Read like a map.

Code is structured, but the why beneath it isn't. Cortex gives that layer cartography — ATTACHed structural memory plus decision walks, traversable by agents.

03

Belong to the IDE.

The right place for this is wherever the developer already is. Cortex ships as MCP. It joins the conversation — it doesn't ask for one of its own.

Position

"We are not building another orchestration platform. We are building the memory layer the orchestration platforms forgot they needed."

§ 04Specs · for the curious

Built
honestly.

Storage
Single .cortex/db graph; durable out-of-repo decision sidecar (~/.cortex/<repoId>/decisions.db)
Indexing
Native cortex-indexer binary for structure; Python venv for ML clustering; FTS for text
Runtime
Node 20+, MCP SDK; installs as a Claude Code plugin
Capture
Hook-based (SessionStart + PreToolUse), low-friction; records decisions as reasoning is spoken
Surface
15+ code-query MCP tools + decision/PR/TODO management, 4 skills, 2 hooks, 2D frames viewer
License
Apache 2.0
Take a look

Cortex is open
and quietly working.

Install it as a Claude Code plugin, or read the source. We're listening for what to build next.

View on GitHub →hello@ruevu.com
claude plugin add github:ruevu/cortex