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