pi-context-repo

Git-backed persistent memory filesystem for pi agents, inspired by Letta Code's Context Repositories.

Install

pi install /path/to/pi-context-repo
# or after publishing:
pi install npm:pi-context-repo

How it works

Memory is stored as markdown files with YAML frontmatter in .pi/memory/ (a separate git repo inside your project).

• system/ files are pinned to the system prompt every turn

• Other files appear in the tree — the agent reads them on demand (progressive disclosure)

• Git versioning tracks all memory changes with informative commits

• Frontmatter enforces description, limit, and optional read_only per file

• $MEMORY_DIR env var injected into shell so bash commands can reference memory

Scaffolded structure (auto-created on first run)

.pi/memory/
├── system/
│   ├── persona.md  — Agent identity and behavior
│   ├── user.md     — User preferences and context
│   ├── project.md  — Codebase knowledge and conventions
│   └── style.md    — Coding preferences
└── reference/
    └── README.md   — How to use reference/

Tools

Tool	Description
memory_write	Write/update a memory file (auto-stages, respects read_only)
memory_delete	Delete a memory file and stage the removal
memory_commit	Commit staged changes with a descriptive message
memory_search	Search memory files by content (git grep)
memory_log	Show recent commit history
memory_backup	Create a timestamped backup snapshot

Commands

Command	Description
/memory	Show tree, status, and recent history
/init	Initialize or re-analyze memory
/remember [text]	Explicitly save something to memory
/memory-diff	Show uncommitted changes
/memory-backup	Create a timestamped backup
/memory-backups	List available backups
/memory-restore	Restore from a backup
/memory-export	Export memory to a directory
/memory-import	Import memory from another directory

UI

• Status widget shows uncommitted/unpushed counts in pi footer
• Sync reminder in system prompt when changes need committing/pushing
• Reflection reminder every 15 turns prompting memory consolidation
• Drift detection warns about legacy/orphan memory fragments in system prompt

Design

Adapted from Letta Code's memoryGit.ts and Context Repositories concept:

• Files as memory units with metadata frontmatter
• system/ subdir always loaded (like Letta's pinned memory blocks)
• File tree always visible for on-demand loading
• Git for versioning, history, and eventual multi-agent sync
• Natural memory application — no "I remember that..." narration
• Git worktree helpers for isolated background edits (reflection, migration)
• System prompt drift detection and stripping
• $MEMORY_DIR / $PI_MEMORY_DIR env vars for shell access