C

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

cdeustOwner verifiedcaution

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

Trust & Reputation

HOL Trust Score
72

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
100pts
MCP Posture
100pts
Plugin Security
64pts
Provenance
70pts
Publisher Quality
75pts

Registry Snapshot

Publisher verification
No
Marketplace source
Unknown
Scanner
Broker fallback
Safety label
caution
Digest verified
Yes
13 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score
72

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
100pts
MCP Posture
100pts
Plugin Security
64pts
Provenance
70pts
Publisher Quality
75pts

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

caution
Safety label
64
Security score
0
High findings
Provider
registry-broker-fallback
Grade
D · caution
Version
Unknown
cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.websiteURL

websiteURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

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.

Claude Code plugin docs
  1. 1

    Add the marketplace

    Run this inside a Claude Code session.

    claude code
  2. 2

    Install the plugin

    Use the plugin name and the marketplace name shown by the previous command.

    claude code
  3. 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.

Share
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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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).

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md
  • 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.

    Raw SKILL.md

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…