websiteURL should be present for marketplace readiness.
Cortex
Persistent thermodynamic memory and cognitive-profiling MCP server for Claude Code, Codex, and Gemini CLI — heat/decay dynamics, predictive-coding write gates, knowledge graph, and intent-aware recall across sessions
cdeust/hypermnesia-mcp · v4.23.5 · Tools & Integrations
Trust Score
72
Security
64
Surfaces
14
What is Cortex?
Cortex is a published tools & integrations plugin for AI coding agents in the claude-code ecosystem, developed by cdeust and distributed through the HOL AI plugin registry. Persistent thermodynamic memory and cognitive-profiling MCP server for Claude Code, Codex, and Gemini CLI — heat/decay dynamics, predictive-coding write gates, knowledge graph, and intent-aware recall across sessions
- Canonical slug
- cdeust/hypermnesia-mcp
- Version
- v4.23.5 · updated Oct 9, 2026
- Open data
- entity.json (JSON-LD)
Trust & Reputation
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
Registry Snapshot
- Repository
- https://github.com/cdeust/Cortex
- Homepage
- https://github.com/cdeust/Cortex
- Canonical profile
- https://hol.org/registry/plugins/cdeust%2Fhypermnesia-mcp
- Publisher verification
- No
- Marketplace source
- Unknown
- Scanner
- Broker fallback
- Safety label
- caution
- Digest verified
- Yes
Trust & reputation
Trust & Reputation
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
Provenance
- Plugin root
- .
- Source repo
- https://github.com/cdeust/Cortex
- Source commit
- 48c31683d452…
- Publisher verified
- No
- Owner verified
- @cdeust
Continuous scanner CI detected
No action is required. This plugin receives the full trust score.
Verified badge not detected
Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.
Security Posture
- Provider
- registry-broker-fallback
- Grade
- D · caution
- Version
- Unknown
Findings
privacyPolicyURL should be present for marketplace readiness.
termsOfServiceURL should be present for marketplace readiness.
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cortex — Frequently asked questions
- What is Cortex?
- Cortex is an AI plugin in the HOL registry. Persistent thermodynamic memory and cognitive-profiling MCP server for Claude Code, Codex, and Gemini CLI — heat/decay dynamics, predictive-coding write gates, knowledge graph, and intent-aware recall across sessions
- How do I install Cortex?
- Install Cortex in your harness: Claude Code — /plugin marketplace add cdeust/Cortex; Antigravity CLI — npx skills add cdeust/Cortex; MCP — git clone https://github.com/cdeust/Cortex. Full step-by-step guidance is on the HOL plugin page.
- How do I install Cortex in Claude Code?
- To install Cortex in Claude Code, start with /plugin marketplace add cdeust/Cortex. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
- How do I install Cortex in Antigravity CLI?
- To install Cortex in Antigravity CLI, start with npx skills add cdeust/Cortex. The complete step-by-step install guide for Antigravity CLI is on the HOL plugin page.
- How do I install Cortex in MCP?
- To install Cortex in MCP, start with git clone https://github.com/cdeust/Cortex. The complete step-by-step install guide for MCP is on the HOL plugin page.
- Is Cortex free?
- Pricing for Cortex is published on its HOL plugin page when the maker schedules a launch.
- Who publishes Cortex?
- Cortex is published by cdeust and listed on HOL.
- Is Cortex available now?
- Cortex availability is listed on its HOL plugin page.
Install Guidance
Install in Claude Code
Install through the Claude Code plugin marketplace.
- 1
Add the marketplace
Run this inside a Claude Code session.
claude code - 2
Install the plugin
Use the plugin name and the marketplace name shown by the previous command.
claude code - 3
Scripted alternative
Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.
shell
Plugin Manifest
{
"name": "hypermnesia-mcp",
"description": "Cortex — persistent memory for Claude Code that remembers across sessions automatically. Install and forget. Scientific retrieval backed by 97 published references. (Renamed from the 'cortex' plugin to match the PyPI/MCP-registry identity.)",
"version": "4.23.5",
"author": {
"name": "Clement Deust",
"email": "[email protected]"
},
"homepage": "https://github.com/cdeust/Cortex",
"repository": "https://github.com/cdeust/Cortex",
"license": "MIT",
"keywords": [
"memory",
"persistent",
"mcp",
"claude-code",
"neuroscience",
"agents"
],
"agents": [
"./claude-agents/cortex-wiki-groomer.md"
],
"userConfig": {
"database_url": {
"type": "string",
"title": "Cortex database URL (optional — PostgreSQL only)",
"description": "Leave empty for the default zero-config SQLite store (~/.claude/methodology/memory.db). To use PostgreSQL instead, set a connection string (postgresql://[user[:pass]@]host[:port]/dbname) — a non-empty value here always wins over the SQLite default and is never silently downgraded. Your value persists across plugin updates.",
"default": ""
}
},
"mcpServers": "./.registry/mcp.json",
"postInstall": {
"command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/install-plugin.sh",
"message": "Installing Cortex (Python deps + zero-config SQLite memory; existing PostgreSQL installs are detected and kept). Upgrade anytime: bash <plugin>/scripts/install-plugin.sh --postgres"
},
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.decision_gate'"
},
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.no_deps_gate'"
}
]
}
],
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.session_start'",
"timeout": 30
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.auto_recall'",
"timeout": 5
}
]
}
],
"PostToolUse": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.post_tool_capture'",
"timeout": 10
}
]
},
{
"matcher": "Edit|Write|Read",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.preemptive_context'",
"timeout": 5
}
]
},
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.pipeline_impact_bump'",
"timeout": 5
}
]
},
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.post_commit_reindex'",
"timeout": 10
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.session_lifecycle'",
"timeout": 30
}
]
}
],
"Notification": [
{
"matcher": "compacted",
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.compaction_checkpoint'",
"timeout": 10
}
]
}
],
"SubagentStart": [
{
"hooks": [
{
"type": "command",
"command": "bash -c 'PY=$(command -v python3 || command -v python) && if [ -z \"${CLAUDE_PLUGIN_ROOT:-}\" ]; then echo \"cortex hook: CLAUDE_PLUGIN_ROOT is unset; refusing to guess the plugin root\" >&2; exit 1; fi; ROOT=\"$CLAUDE_PLUGIN_ROOT\" && \"$PY\" \"$ROOT/scripts/launcher.py\" mcp_server.hooks.agent_briefing'",
"timeout": 5
}
]
}
]
},
"interface": {
"displayName": "hypermnesia-mcp",
"developerName": "cdeust"
},
"skills": "./",
"holManifestOrigin": "repository",
"registryIndexVersion": 5
}Marketplace Source
- Repo URL
- https://github.com/cdeust/Cortex
- Marketplace path
- Unknown
- Source path
- .
- Install policy
- Unspecified
Skills
13 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.
cortex-automate
skills/cortex-automate/SKILL.md
Set up automation — prospective memory triggers, neuro-symbolic rules, and CLAUDE.md sync. Use when the user says 'remind me when', 'trigger when', 'create a rule', 'auto-remember', 'sync to CLAUDE.md', 'push insights', 'set up trigger', 'when I open this file', 'when this keyword appears', or when you want to automate memory behavior based on conditions.
cortex-consolidate
skills/cortex-consolidate/SKILL.md
Run memory maintenance — decay old memories, compress stale content, consolidate episodic memories into semantic knowledge, and run sleep-like replay. Use when the user says 'clean up memories', 'consolidate', 'run maintenance', 'compress old memories', 'memory cleanup', or periodically to keep the memory system healthy. Also use after importing many memories or at the end of a long session.
cortex-debug-memory
skills/cortex-debug-memory/SKILL.md
Debug and fix memory system issues — validate memories, rate quality, manage protection, forget bad memories, and restore from checkpoints. Use when the user says 'fix memory', 'bad memory', 'wrong memory', 'delete this', 'protect this', 'this memory is wrong', 'memory quality', 'rate this memory', 'restore checkpoint', 'undo', or when memories are returning incorrect or stale results.
cortex-explore-memory
skills/cortex-explore-memory/SKILL.md
Explore the memory system's state, find gaps in knowledge, assess coverage, and get diagnostic information. Use when the user asks 'what does my memory look like', 'show me memory stats', 'what am I missing', 'how good is my knowledge', 'memory health', 'show coverage', 'find gaps', 'what topics are weak', or when you need to understand the state of stored knowledge before a task.
cortex-import
skills/cortex-import/SKILL.md
Import memories from other AI memory systems into Cortex. Supports claude-mem (SQLite), Claude Desktop sessions, ChatGPT web export (JSON), Gemini Takeout (JSON), Cursor conversations, and Claude Code JSONL. Use when the user says 'import from claude-mem', 'migrate memories', 'import ChatGPT history', 'import from Gemini', 'transfer memories', or when Cortex detects another memory system is installed.
cortex-navigate-knowledge
skills/cortex-navigate-knowledge/SKILL.md
Navigate the knowledge graph — trace entity relationships, explore causal chains, drill into memory clusters, and traverse co-access paths. Use when the user asks 'how are these related', 'what connects X to Y', 'show me the knowledge graph', 'trace the relationship', 'what caused X', 'drill down into', 'explore connections', or when you need to understand the web of relationships between concepts, entities, and memories.
cortex-profile
skills/cortex-profile/SKILL.md
View and manage your cognitive profile — how you think, work patterns, blind spots, and cross-domain connections. Use when the user says 'show my profile', 'how do I work', 'what are my patterns', 'cognitive style', 'blind spots', 'methodology', or at the start of a session to load context. Also use 'rebuild profile' to rescan all session history, or 'list domains' to see all tracked project domains.
cortex-recall-global
skills/cortex-recall-global/SKILL.md
Search and retrieve global memories — knowledge that applies across all projects. Use when the user asks 'what are our coding standards', 'what conventions do we follow', 'what's our infrastructure setup', 'do we have a rule about', 'what applies to all projects', 'shared knowledge', 'global rules', or when you need cross-project context like architecture decisions, server configs, or team policies.
cortex-recall
skills/cortex-recall/SKILL.md
Search and retrieve memories from Cortex persistent memory. Use when the user asks 'what did we decide about X', 'do you remember', 'what was the fix for', 'find that thing about', 'search memories', 'what do we know about', 'have we seen this before', or when you need context about past decisions, patterns, bugs, or architecture choices. Also use proactively when working on something that likely has relevant historical context.
cortex-remember-global
skills/cortex-remember-global/SKILL.md
Store a global memory that is visible across all projects. Use when the user shares architecture rules, coding conventions, infrastructure facts, security policies, team agreements, or any knowledge that applies beyond a single project. Triggers on 'remember this everywhere', 'this applies to all projects', 'global rule', 'shared convention', 'infrastructure note', 'cross-project', or when the content is clearly universal (clean architecture, SOLID, deployment configs, server addresses).
cortex-remember
skills/cortex-remember/SKILL.md
Store important decisions, patterns, errors, lessons, and context into Cortex persistent memory. Use when the user says 'remember this', 'save this', 'store this for later', 'note this down', 'don't forget', 'this is important', 'bookmark this', or when a significant decision, bug fix, architecture choice, or lesson learned occurs during a session. Also use after resolving tricky bugs, making technology choices, or discovering important patterns.
cortex-setup-project
skills/cortex-setup-project/SKILL.md
Bootstrap Cortex for a new project or import existing session history. Use when the user says 'set up Cortex', 'seed this project', 'import my history', 'backfill memories', 'bootstrap memory', 'initialize Cortex for this project', or when starting to use Cortex on an existing codebase that already has Claude Code conversation history.
cortex-wiki-author
skills/cortex-wiki-author/SKILL.md
Author first-class wiki pages (ADRs, specs, file docs, notes) that live alongside Cortex memory. Use when the user says 'this is an ADR', 'document this decision', 'write an ADR', 'add a spec', 'spec this out', 'document this file', 'add a note about', 'link these pages', 'bookmark this as a spec', or when finalizing a design decision that should persist as a human-readable document.
File Inventory
.claude-plugin/plugin.json
file
7,224 bytes
f9d68010f119c39c…
.codex-plugin/plugin.json
plugin-manifest
5,770 bytes
ae07795c45300bfe…
.registry/mcp.json
mcp-config
217 bytes
85e3653727e0f747…
claude-agents/cortex-wiki-groomer.md
file
7,990 bytes
b8cc73e967a7999f…
CLAUDE.md
file
1,618 bytes
a0c8c7fbc5c6ba69…
commands/methodology.md
file
818 bytes
714cdc8cf354f84b…
commands/preflight.md
file
1,624 bytes
22f9d48151e201a7…
commands/why.md
file
2,000 bytes
2937a271977752c0…
gemini-extension.json
file
484 bytes
c546128b81083235…
package-lock.json
file
219 bytes
f57dca070ca23863…
package.json
file
261 bytes
9bbaa74a710b9106…
README.md
file
30,767 bytes
b0aebd5b0371d324…
SECURITY.md
file
9,049 bytes
1eca7fdf79b6ebdc…
skills/cortex-automate/SKILL.md
skill
4,053 bytes
b843b61928dd0606…
skills/cortex-consolidate/SKILL.md
skill
3,349 bytes
78e9bc2e215fd527…
skills/cortex-debug-memory/SKILL.md
skill
3,575 bytes
0405a094c969fbc4…
skills/cortex-explore-memory/SKILL.md
skill
3,099 bytes
a03a2d050ab9b246…
skills/cortex-import/SKILL.md
skill
7,641 bytes
454c83052deb571d…
skills/cortex-navigate-knowledge/SKILL.md
skill
3,584 bytes
5b78d8c621535a6c…
skills/cortex-profile/SKILL.md
skill
3,856 bytes
ff41b32535bf1199…
skills/cortex-recall-global/SKILL.md
skill
3,484 bytes
b54e802ab488945f…
skills/cortex-recall/SKILL.md
skill
3,635 bytes
850705cc79bdf065…
skills/cortex-remember-global/SKILL.md
skill
4,287 bytes
a7235c276e0ea70d…
skills/cortex-remember/SKILL.md
skill
3,630 bytes
c5042997b4635f94…
skills/cortex-setup-project/SKILL.md
skill
4,604 bytes
bd19a3d9a4af0665…
skills/cortex-wiki-author/SKILL.md
skill
4,450 bytes
68fde7023ef16396…