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