@artale/pi-memory

Persistent memory for Pi sessions

Package details

← Back

package

Install @artale/pi-memory from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@artale/pi-memory

Package: @artale/pi-memory
Version: 1.2.0
Published: Apr 28, 2026
Downloads: 212/mo · 176/wk
Author: artale
License: MIT
Types: package
Size: 19.8 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "tools": [
    "remember",
    "forget",
    "recalls"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-memory

Persistent memory for Pi. Learns patterns and decisions per project, recalls context across sessions, generates handover docs.

Install

pi install npm:@artale/pi-memory

How it works

Two memory layers:

MEMORY.md — project-level knowledge base. Patterns, decisions, gotchas, architecture notes. Lives in the project root.
Episodic memory — JSONL log of insights with timestamps. Lives in ~/.pi/memory/episodes/.

Tools

memory_learn — record a learning/insight (pattern, decision, gotcha, architecture, process)
memory_recall — search project memory + episodic memory for context
memory_handover — generate handover document (focus, blockers, next actions, learnings)

Examples

The agent discovers a gotcha:
→ memory_learn({ insight: "Windows paths need forward slashes in bash", category: "gotcha" })

Next session, the agent recalls:
→ memory_recall({ query: "windows paths" })
→ Returns: "Windows paths need forward slashes in bash" + related episodes

End of session:
→ memory_handover({ summary: "Fixed build pipeline", nextActions: ["Deploy to staging"] })

License

MIT