chandra447/pi-hermes-memory

持久内存 + 会话搜索 + Pi 秘密扫描

---

你的Pi代理通常在你关闭会话时会忘记所有内容。这个扩展解决了这个问题。

• 🔍 搜索每一段对话 — “我们讨论了关于认证的内容？”即时找到
• 🧠 持久记忆——事实、偏好、更正在会话间存续
• ⚠️ 从失败中学习 — 记住哪些地方不行，避免重蹈覆辙
• 🏷️ 分类记忆——失败、修正、洞见、惯例和工具怪癖，为快速检索而组织
• 🛡️ 秘密扫描 — API 密钥和令牌被阻止保存
• 📚 程序性技能 — 代理保存如何解决问题，而不仅仅是解决了什么
• ⚡ 背景学习 — 每10回合复习一次，保存重要内容
• 🔄 自动合并 — 条目满时合并，数据从不丢失

快速启动

升级笔记（v0.7.10）

如果你是从旧版本升级，启动功能现在会自动安全地迁移扩展数据：

• 遗留扩展根：~/.pi/agent/memory → ~/.pi/agent/pi-hermes-memory
• 传承平行技能：~/.pi/agent/pi-hermes-memory/skills/*.md → ~/.pi/agent/pi-hermes-memory/skills/ /SKILL.md

Your Pi agent normally forgets everything when you close a session. This extension fixes that.

• 🔍 Search every conversation — “what did we discuss about auth?” finds it instantly
• 🧠 Persistent memory — facts, preferences, corrections survive across sessions
• ⚠️ Learns from failures — remembers what didn’t work so you don’t repeat mistakes
• 🏷️ Categorized memories — failures, corrections, insights, conventions, and tool quirks organized for fast retrieval
• 🛡️ Secret scanning — API keys and tokens are blocked from being saved
• 📚 Procedural skills — the agent saves how it solved problems, not just what
• ⚡ Background learning — reviews every 10 turns, saves what matters
• 🔄 Auto-consolidation — merges entries when full, never loses data

Quick Start

# Install
pi install npm:pi-hermes-memory

# Index your past sessions (one-time)
/memory-index-sessions

# Backfill older Markdown memories into SQLite search (optional)
/memory-sync-markdown

# Learn how to use it
/learn-memory-tool

Upgrade Notes (v0.7.10)

If you’re upgrading from older versions, startup now auto-migrates extension data safely:

• legacy extension root: ~/.pi/agent/memory → ~/.pi/agent/pi-hermes-memory
• legacy flat skills: ~/.pi/agent/pi-hermes-memory/skills/*.md → ~/.pi/agent/pi-hermes-memory/skills//SKILL.md

This resolves Pi skill index conflicts like:

• name "..." does not match parent directory "skills"

No manual action is needed. Launch Pi once after upgrade to let migration/normalization run.

Features

How It Works

Session Lifecycle