memories.sh overview

Local-first unified state layer for coding agents supporting four memory types: session (volatile, cleared per session), semantic (memory.md — persisted facts and preferences), episodic (daily logs of agent interactions), and procedural (workflows and reusable task patterns). Designed as a cross-agent compatibility layer — supports Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, Roo, and Gemini through a shared filesystem layout that each agent can read. All memory is local-first (no cloud dependency), stored as plain files under ~/.memories/, and version-controllable with git. The unified memory type taxonomy makes memories.sh the reference implementation of the four-type memory model.