Skip to main content
Open source

ShieldCortex

Stops a hijacked or prompt-injected AI agent from running destructive commands, leaking secrets, or poisoning memory it writes through ShieldCortex.

ShieldCortex v5.9.0 sits on the door of your agent's native memory. It scans writes that go through it and lets you inspect what was stored. It does not replace OpenClaw, Hermes, or Claude memory. Claude Code and OpenClaw can deny a tool call once Action Guard is on; that guard stays off until you turn it on. An enabled Hermes plugin enforces by default. Codex, Cursor, VS Code and Copilot get an MCP memory server that is a scanner, not a deny. Requires Node 22.14+ or Node 24.

Free open source · MIT licensed · npm install shieldcortex

Injection ScanPattern MatchEntropy CheckIron DomeQuarantineMemory StorememoryinjectBLOCKEDinputstored
6-layer pipelineSafe memoryBlocked threat

Features

What it does.

Inspectable Memory

See what the agent stored, where it came from, and what it would recall next. Capture, Recall, Review, and graph views turn memory into an operator-controlled workflow.

Inspectable Recall

Search and review what was stored, and choose whether recall reaches the agent at all. Native OpenClaw / Hermes / Claude memory stays the brain; ShieldCortex is the door.

Memory Poisoning Defence

Every memory write passes through a 6-layer defence pipeline covering prompt injection, encoding tricks, paraphrased attacks, format anomalies, behavioural anomalies, and credential leakage before it lands.

Iron Dome Behavioural Protection

Agent-aware security for what your AI can do, not only what it remembers: injection scanning, action gates, a PII guard and an emergency kill switch. Action Guard stays off until you turn it on. Claude Code, OpenClaw and Hermes can deny a call; Codex, Cursor, VS Code and Copilot MCP is a scanner, not a deny.

Environment Firewall

Third defence layer — protects what the agent sees. shieldcortex env scan <url> scores provenance, detects hidden instructions (display:none, visibility:hidden, bidi overrides, same-colour text), and runs injection scanning on visible and hidden surfaces separately. A prompt-injection hit inside hidden content marks the page hostile regardless of the domain.

MCP-Native Workflows

Claude Code and OpenClaw can deny a tool call once Action Guard is on. An enabled Hermes plugin enforces by default. Codex, Cursor, VS Code and Copilot get an MCP memory server the model may call: a scanner, not a deny.

X-Ray Scanner

Deep file and dependency analysis for prompt injection, steganographic payloads, obfuscated code, credential leaks, risky packages, and CI gatekeeping before bad code lands.

Operator Review Workflows

Suppress, archive, pin, canonicalize, merge, and replay. Teams can investigate incidents, review suspicious memory, and keep future recall under control instead of trusting a black box.

Open Source, MIT Licensed

Free and open source under the MIT licence. The full defence pipeline, custom patterns and policies, audit export, X-Ray scanning, and the Cortex memory system all run locally at no cost.

Structured Memory Types

v4 organises memory into four typed categories — user preferences, feedback from corrections, project context, and reference knowledge — so recall is always scoped to the right kind of information.

Staleness Scoring & Decay

Memories age. v4 applies time-based decay scoring so stale entries sink in relevance, with operator warnings when recalled memories are old enough to be unreliable.

LLM-Powered Reranking

Hybrid recall combines vector similarity with an LLM reranking pass, surfacing the most contextually precise memories instead of just the nearest embeddings.

Dream Mode Consolidation

Run shieldcortex consolidate to trigger background memory consolidation — like sleep for your AI. Dream mode merges duplicates, resolves contradictions, and strengthens important memories offline.

Memory Scopes

Private and team scopes let multi-agent fleets share project context while keeping per-agent preferences isolated. Control exactly what crosses the boundary.

Cloud Replica Sync

Opt-in local-to-cloud replication for memories and graph data, with queue diagnostics, per-project controls, and shared visibility for teams running across multiple devices.

Positive Feedback Capture

v4 doesn't just learn from mistakes. It captures confirmations, successes, and explicit praise so agents reinforce what works — not only what went wrong.

Smart Save Filtering

Before a memory is written, v4 checks whether it's derivable from existing entries or redundant. Duplicate and low-value information is blocked at the gate, keeping memory lean.

How it works

3 simple steps.

1

Capture

Install ShieldCortex on the host you already run. Native memory stays the brain. Writes that go through ShieldCortex get provenance, trust scoring, and a defence scan before they stick.

2

Inspect

Use Capture, Recall, and Review to see what the agent stored, what it would retrieve, and what should be suppressed, merged, archived, or marked canonical.

3

Protect

Every memory write is scanned through all six layers. Iron Dome gates risky behaviour. Cloud teams then use Device Doctor, Verify, Replay, and Review to investigate incidents and remediate them.

Part of ShieldCortex

Iron Dome — behavioural security

The memory firewall protects what your agent stores. Iron Dome protects what it does. Six defensive layers — instruction gateway, injection scanner, action gating, PII protection, kill switch, and audit trail — with four ready-made profiles for personal, school, enterprise, and paranoid deployments. Free and MIT licensed, included with ShieldCortex.

See It In Action

Watch ShieldCortex block a prompt injection and privilege escalation in real time.

Also on X/Twitter

Pricing

Simple, transparent pricing.

Recommended

Free

£0

Everything runs locally — free, open source, MIT licensed

  • ✓Full 6-layer defence pipeline
  • ✓Iron Dome with custom policies
  • ✓Custom injection patterns + firewall rules
  • ✓Credential leak detection (25+ patterns)
  • ✓Audit export (JSON/CSV)
  • ✓X-Ray scanner + CI gate
  • ✓Cortex memory system + knowledge graph
  • ✓Operator recall and search (FTS5). Prompt-time recall into Claude Code is not automatic
  • ✓Structured memory types, staleness scoring & decay
  • ✓Local dashboard
  • ✓Agent hooks (OpenClaw, Claude Code)
  • ✓Free cloud tier (500 scans/month sync)

Enterprise

Custom

For teams and fleets — contact us

  • ✓Everything in Free
  • ✓Fleet deployment and management
  • ✓Memory sync at scale
  • ✓SSO + volume licensing
  • ✓Self-hosted deployment
  • ✓SIEM integration + compliance exports
  • ✓Dedicated support + SLA

Frequently Asked Questions

Does ShieldCortex require a cloud account?+
No. ShieldCortex runs entirely on your machine with no cloud, no account, and no telemetry. An optional free cloud account adds replica sync for memories, graph data, and audit logs across devices, with 500 scans a month included. For fleets, always-on servers, and memory sync at scale, Enterprise adds SSO, dedicated support, and an SLA — contact us to discuss.
How does the 6-layer defence pipeline work?+
Every memory write passes through the defence layers: input sanitisation (strips control characters), pattern detection (regex-based prompt injection firewall), semantic analysis (embedding similarity to a curated attack corpus, on the async deep-scan path), structural validation (JSON integrity, format anomalies, fragmentation attempts), behavioural scoring (entropy analysis, anomaly detection, baseline deviation), and credential leak detection (25+ patterns across 11 providers).
What is ShieldCortex best at?+
ShieldCortex is strongest as a door on the native brain: it scans writes that go through it, and on Claude Code, OpenClaw and Hermes it can deny a tool call. Codex, Cursor, VS Code and Copilot MCP is a scanner, not a deny. It does not replace OpenClaw, Hermes or Claude memory, and it does not own their recall. v5.9.0 is the current release on the 5.x line (Node 22.14+ or Node 24). Action Guard stays off until you turn it on. Prompt-time recall into Claude Code is not automatic. It needs the UserPromptSubmit hook, which shieldcortex setup adds when you agree to wire Claude Code (npm install does not), and proactiveRecall set to true. A fresh global, non-CI install with no config file may write that flag; local and CI installs do not. An existing config is left alone. When the key is unset, recall is off.
What is Iron Dome?+
Iron Dome is the behavioural protection layer included free with ShieldCortex. It covers what your AI agent can do, not only what it remembers: injection scanning, action gates, PII protection, an emergency kill switch, and four built-in security profiles (personal, school, enterprise, paranoid). Action Guard stays off until you turn it on. Only Claude Code, OpenClaw and Hermes can deny a tool call; Codex, Cursor, VS Code and Copilot MCP is a scanner, not a deny.
What is the Environment Firewall?+
Environment Firewall is the third defence layer (added in v4.10.0). The memory firewall protects what the agent stores; Iron Dome protects what the agent does; the Environment Firewall protects what the agent sees from the outside world. Run shieldcortex env scan <url> against any page and it returns a taint label (trusted, untrusted, suspicious, hostile) with CI-friendly exit codes. It scores provenance, detects hidden content tricks (display:none, visibility:hidden, bidi overrides, same-colour text, HTML comments, ARIA-hidden regions, meta refreshes), and runs injection patterns against visible and hidden text separately — a hit inside hidden content marks the page hostile regardless of the domain, because humans will never see it.
Is there a done-for-you option?+
Yes. Enterprise engagements include done-for-you configuration: we analyse your codebase and agent stack, produce a hardened ShieldCortex config, and support rollout across your fleet. Contact sales@drakonsystems.com to discuss.
Which AI tools does ShieldCortex integrate with?+
Claude Code (PreToolUse), OpenClaw (before_tool_call) and Hermes (pre_tool_call) can deny a tool call. On Claude Code and OpenClaw that gate is Action Guard, and it stays off until you turn it on. A bare sudo shieldcortex protect turns it on and pins that posture. Hermes has its own setting: once you run hermes plugins enable shieldcortex and the local API (shieldcortex api) is up, the plugin enforces by default and ignores the enforce-when-ready readiness gate, which applies only to Claude Code and OpenClaw. Hermes has no approval prompt, so a call that needs approval is blocked, not asked about. SHIELDCORTEX_ENFORCE=0 makes ordinary approval-required calls advisory instead; outright block verdicts and self-protection calls (those that touch the guard's own state or config) still block. Codex, Cursor, VS Code and Copilot get an MCP memory server the model may call. That server is a scanner, not a deny. LangChain and the Python SDK scan only if you call scan or save.
How do Cloud API key scopes work?+
Cloud keys are scope-based. Teams can now edit an existing key instead of revoking and recreating it. Typical sync devices use scan and audit. Add verify when you want the Verify workspace to receive LLM verification jobs. Keep keys and admin scopes for humans rather than unattended devices.
What does Incident Replay actually show?+
Replay is an incident and event reconstruction surface, not a full chat-session movie. It focuses on audit, verify, sync ingest, and synced memory events that matter for investigation, then lets you export reports, scope by device or project, and jump into Review, Capture, or Graph.
What changed in v5.9.0?+
v5.9.0 is a minor release on 5.8.0. All four changes are in Action Guard and the session install lease, and they apply only where those features are on. Action Guard stays off until you turn it on. Heredoc data-read relief returns as a strict allow-list for short interpreter heredocs that only read a data file (#713 / PR #732). Read-only global package queries (for example npm list -g | grep -i x) no longer take or refuse the session install lease (#747 / PR #748). A global install with redirection on the package-manager name (for example npm>/dev/null install -g x) keeps install scope again (#752 / PR #753). A script that builds a global install as an argv list now asks for approval when written (#387 follow-up / PR #744). No export, CLI, config key, default, Node floor or Cloud pin changes.

Secure Your AI Agent Memory with v5.9.0

Scan native memory writes, gate tools, inspect what was stored. Open source, MIT licensed. Get started in under a minute.