v0.2.0 Now Available

Memory for AI Agents
That Actually Works

CORTEX is an automated memory management system that gives your AI agent persistent, searchable knowledge across sessions — with zero manual intervention.

Get Started Free View on GitHub

cortex-cli.py

$ cortex-cli.py search "authentication"

🔍 'authentication' → 12 result(s)

[1] OAuth2-Implementation-8f3a2b.md

T1 (Principle) · D1 (24h) · security_flagged=false

JWT tokens stored in encrypted session cookies...

[2] API-Key-Rotation-4c9d1e.md

T1 (Principle) · D2 (7d) · security_flagged=true

Rotate keys every 90 days, use AWS Secrets Manager...

$ _

Built for Scale

Every feature designed to make your AI agent smarter over time, without manual maintenance.

Real-Time Processing

Session-end hook processes every conversation immediately. No batch delays, no backlog — your agent learns as it goes.

Security Filtering

Automatic credential detection blocks passwords, tokens, and API keys from syncing to Obsidian. 7% of entries flagged and protected.

Smart Classification

Two-dimensional system: Tiers (T1-T4) by importance + Depth (D0-D4) by age. Know what matters and how fresh it is.

Obsidian Sync

Automatic atomic note creation for T1 principles. 878 notes synced with proper frontmatter, tags, and backlinks.

Auto MOC Generation

5+ notes on a topic? CORTEX generates a Map of Content automatically. 179 MOCs created, zero manual work.

Intelligent Eviction

Tier-first + LRU policy. T4 logs auto-pruned after 30 days. T1/T2 principles protected forever. Database stays lean.

Not Your Average Memory System

CORTEX evolves graymatter v2 with automation, security, and intelligent organization.

Feature	Manual	graymatter v2	CORTEX v0.2.0
Classification	None	Depth (D0-D4)	Tier (T1-T4) + Depth
Security Filtering	❌	❌	✅ Auto-detect
Deduplication	❌	❌	✅ SHA256 hash
Processing	Manual	Batch (nightly)	Real-time hook
Obsidian Sync	Manual	❌	✅ Atomic notes
MOC Generation	Manual	Manual	✅ Auto (5+ notes)
Eviction Policy	❌	❌	Tier-first + LRU
Automation	None	Cron setup	Pre-configured

System Architecture

Built on SQLite FTS5 for millisecond search. Enhanced with fingerprinting, security, and cross-system tracking.

/HOME/.hermes/context/stats.db (42 MB)

├── fts_index FTS5 virtual table

• skill, command, content

• timestamp, tier, filepath

• content_hash (SHA256) ← NEW

• security_flagged ← NEW

• security_resolved, security_reason ← NEW

└── content_references Cross-system tracking

• hermes, graymatter, obsidian flags ← NEW

• ref_count, first_seen, last_updated ← NEW

Daily Pipeline (00:00 → 00:05)

00:00 midnight-reflection.py → Process daily entries

00:05 lyt-mind-mapper.py → Generate MOCs

08:00 cortex-cli.py status → Morning report

Ready to Give Your Agent Real Memory?

Join 1,000+ AI developers using CORTEX for automated knowledge management.

Install CORTEX Free Read Documentation

Open source • MIT License • Self-hosted

Memory for AI Agents That Actually Works