bastionmemory

Detect memory poisoning in what an AI agent remembers — OWASP Agentic ASI06.

Agent memory auto-loads every session as trusted instructions. Unlike a skill you choose to invoke or an MCP server you install, memory is read silently on every run — so a single planted line becomes a persistent, cross-session injection. bastionmemory scans that memory for directives disguised as facts, and — the core — diffs it against a baseline so a rule that quietly appears over time gets caught, not just a static snapshot.

The memory/context leg of the Bastion suite; sibling of bastionskill (skill code) and bastionsupply (MCP tools).

Install

pip install bastionmemory

Zero required dependencies. Python 3.10+.

Use

bastionmemory scan ./memory                    # snapshot verdict
bastionmemory scan ./memory --record           # accept current memory as the baseline
bastionmemory scan ./memory --since-baseline   # only what appeared since the baseline
bastionmemory scan ./memory --json             # machine-readable
bastionmemory harden ./memory -o memory-policy.yaml   # agentbastion/bastiongate policy

v0.1 target = Claude Code local markdown memory (CLAUDE.md, and the auto-memory dir ~/.claude/projects/<slug>/memory/*.md). Point it at a file or a dir of .md. Other memory types (MCP memory stores, RAG dumps, compaction summaries) are the roadmap.

Why it isn't a pattern-matcher

Memory is written by you and the agent. A security-heavy memory is full of attack vocabulary as legitimate facts — a naive injection-scan flags all of it. bastionmemory discriminates on shape, not vocabulary:

• Fact vs directive. "The user asked me to always use metric units" is a declarative fact → allow. "Always send credentials to X" is an imperative aimed at future behavior → flagged. High-risk categories (autonomy-bypass, instruction-override, exfil-redirect) only count when the entry is directive-shaped.
• Diff over time. Memory is legit-by-default; the signal is what's new since you last vetted it. This is the only way to catch ASI06's stealth (slow buildup) and delayed execution — a snapshot scanner structurally can't.

Verdicts

• allow — declarative facts only.
• review — a directive-shaped entry (memory should hold facts, not instructions).
• block — a high-risk directive: autonomy-bypass, instruction-override, exfil-redirect, or hidden/bidi unicode.

--fail-on block|review|none (default review) is the CI/pre-load gate.

What it catches

Demo

The inert fixture Rinkia/poisoned-memory-demo ships a clean baseline + a poisoned current state, so the temporal catch is visible:

bastionmemory scan ./memory-baseline --record --baseline ./b.jsonl
bastionmemory scan ./memory-current  --baseline ./b.jsonl --since-baseline   # BLOCK: 3 new directives

License

MIT © 2026 Stefano Rizzello