pi-hermes-memory 0.4.5 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +40 -17
  2. package/package.json +11 -4
package/README.md CHANGED
@@ -4,30 +4,53 @@
4
4
 
5
5
  # 🧠 Pi Hermes Memory
6
6
 
7
+ **Persistent memory + session search + secret scanning for Pi**
8
+
9
+ [![npm version](https://img.shields.io/npm/v/pi-hermes-memory.svg)](https://www.npmjs.com/package/pi-hermes-memory)
10
+ [![tests](https://img.shields.io/badge/tests-272-green.svg)](#testing)
11
+ [![license](https://img.shields.io/npm/l/pi-hermes-memory.svg)](LICENSE)
12
+
13
+ ---
14
+
7
15
  </div>
8
16
 
9
- A [Pi coding agent](https://github.com/badlogic/pi-mono) extension that gives your AI agent **persistent memory across sessions** and a **self-directed learning loop** ported from the [Hermes agent](https://github.com/nousresearch/hermes-agent) harness.
17
+ Your Pi agent normally forgets everything when you close a session. **This extension fixes that.**
18
+
19
+ - 🔍 **Search every conversation** — "what did we discuss about auth?" finds it instantly
20
+ - 🧠 **Persistent memory** — facts, preferences, corrections survive across sessions
21
+ - 🛡️ **Secret scanning** — API keys and tokens are blocked from being saved
22
+ - 📚 **Procedural skills** — the agent saves *how* it solved problems, not just what
23
+ - ⚡ **Background learning** — reviews every 10 turns, saves what matters
24
+ - 🔄 **Auto-consolidation** — merges entries when full, never loses data
25
+
26
+ ## Quick Start
10
27
 
11
- ## What It Does
28
+ ```bash
29
+ # Install
30
+ pi install npm:pi-hermes-memory
31
+
32
+ # Index your past sessions (one-time)
33
+ /memory-index-sessions
34
+
35
+ # Learn how to use it
36
+ /learn-memory-tool
37
+ ```
12
38
 
13
- Your Pi agent normally forgets everything when you close a session. This extension fixes that.
39
+ ## Features
14
40
 
15
41
  | Feature | What happens |
16
42
  |---|---|
17
- | **Persistent Memory** | The agent saves facts, preferences, and lessons to markdown files that survive restarts |
18
- | **Procedural Skills** | The agent saves *how* it solved problems as reusable skill documents |
19
- | **Background Learning** | Every 10 turns (or 15 tool calls) the agent reviews your conversation and proactively saves what it learned |
20
- | **Correction Detection** | When you correct the agent ("no, don't do that"), it saves immediately no waiting |
21
- | **Auto-Consolidation** | When memory hits capacity, the agent automatically merges and prunes entries instead of erroring |
22
- | **Session Flush** | Before context is compressed or the session ends, the agent gets one last chance to save anything worth remembering |
23
- | **Onboarding Interview** | `/memory-interview` answer 5-7 questions to pre-fill your profile on the very first session |
24
- | **Context Fencing** | Memory blocks are wrapped in `<memory-context>` tags so the LLM never treats stored facts as user instructions |
25
- | **Memory Aging** | Entries carry timestamps consolidation knows which facts are stale and which are fresh |
26
- | **Project Memory** | Per-project memory (`~/.pi/agent/<project>/MEMORY.md`) alongside your global memory |
27
- | **Secret Detection** | API keys, tokens, SSH keys, and credential assignments are blocked from being persisted to memory |
28
- | **Session History Search** | Search across all past conversations via SQLite FTS5 — "what did we discuss about auth?" |
29
- | **Extended Memory Store** | Unlimited searchable memories beyond the core 5,000-char limit |
30
- | **Learn Memory Tool** | `/learn-memory-tool` — a skill that teaches users how to use the memory system |
43
+ | 🔍 **Session Search** | Search across all past conversations via SQLite FTS5 |
44
+ | 🧠 **Persistent Memory** | Facts, preferences, lessons saved to markdown files |
45
+ | 📚 **Procedural Skills** | The agent saves *how* it solved problems as reusable docs |
46
+ | **Background Learning** | Every 10 turns (or 15 tool calls) the agent reviews and saves |
47
+ | 🔧 **Correction Detection** | When you correct the agent, it saves immediately |
48
+ | 🔄 **Auto-Consolidation** | When memory hits capacity, auto-merges instead of erroring |
49
+ | 🛡️ **Secret Scanning** | API keys, tokens, SSH keys blocked from persistence |
50
+ | 📊 **Memory Aging** | Entries carry timestamps consolidation knows what's stale |
51
+ | 🏗️ **Two-Tier Memory** | Global + per-project memory, both searchable |
52
+ | 💾 **Extended Store** | Unlimited searchable memories beyond core 5,000-char limit |
53
+ | 🎓 **Onboarding** | `/memory-interview` pre-fills your profile on first session |
31
54
 
32
55
  ## How It Works
33
56
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pi-hermes-memory",
3
- "version": "0.4.5",
4
- "description": "Your Pi agent remembers everything across sessions your preferences, your stack, your corrections, and even how it solved problems. Zero-config install, works immediately. Persistent memory + procedural skills + auto-correction detection + security-first content scanning.",
3
+ "version": "0.5.1",
4
+ "description": "🧠 Persistent memory + 🔍 session search + 🛡️ secret scanning for Pi. SQLite FTS5 search across every conversation, auto-consolidation, memory aging, procedural skills. 272 tests. Ported from Hermes agent.",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
7
7
  "files": [
@@ -23,14 +23,21 @@
23
23
  "pi-package",
24
24
  "pi-extension",
25
25
  "memory",
26
+ "persistent-memory",
27
+ "session-search",
28
+ "sqlite",
29
+ "fts5",
26
30
  "skills",
27
31
  "learning-loop",
28
32
  "agent",
29
33
  "hermes",
30
- "persistent-memory",
34
+ "secret-scanning",
31
35
  "content-scanner",
32
36
  "correction-detection",
33
- "auto-consolidation"
37
+ "auto-consolidation",
38
+ "memory-aging",
39
+ "context-fencing",
40
+ "two-tier-memory"
34
41
  ],
35
42
  "license": "MIT",
36
43
  "repository": {