plur-memory

PLUR Memory

Persistent memory for AI agents. Corrections, preferences, and patterns are stored as engrams that strengthen with use and decay when irrelevant. The system gets smarter the longer you use it.

When to Use

Always. Memory is not a feature you toggle — it's a layer that runs continuously.

The plugin automatically injects relevant engrams into every conversation turn via the pre_llm_call hook. You don't need to call plur_inject manually unless you want full hybrid search (the automatic path uses fast BM25 search).

Memory Lifecycle

• Automatic injection runs every turn — relevant engrams appear in your context as <plur-memory> blocks
• When you discover something worth remembering → call plur_learn with a clear statement
• When corrected by the user → call plur_learn immediately with the correction
• When an injected engram was helpful → call plur_feedback with signal "positive"
• When an injected engram was wrong or stale → call plur_feedback with signal "negative"
• When a memory is no longer true → call plur_forget with the engram ID

The Learning Protocol

End your responses with a learning section when you discover reusable insights:

---
🧠 I learned:
- Insight one (min 10 characters)
- Insight two

The plugin auto-captures these — no manual plur_learn call needed. This is a convenience fallback; calling plur_learn directly is preferred for important learnings.

The Memory Line

End every reply with one short line: Memory — recalled N · used: ENG-…, ENG-… · written: ENG-… (recalled as a count; used and written as ids only, no statements), or Memory — none. Only count/list ids you actually saw this turn; never invent an id. Give details only if the user asks.

Getting Started

On first install, PLUR has zero engrams — injection returns empty. This is expected.

Your first 5 sessions are the bootstrap period. Actively learn:

• Call plur_learn for every correction the user makes
• Call plur_learn for stated preferences ("always use X", "never do Y")
• Call plur_learn for discovered patterns and conventions