I Built a Free, Git-Native Memory Layer for AI Agents — Here's Why and How

The Problem I Couldn't Stop Thinking About I use AI agents constantly — Claude on Windows, Claude on macOS via Codex, GPT-4o for a second opinion. Every session, the agent is a stranger. It doesn't know my preferences, my projects, nothing. The existing "memory" solutions all had the same issues: paid APIs, data on their servers, single-model lock-in. None of it felt right. So I built agent-soul: a Git-native memory framework. Free. Private. Works with any LLM. The Architecture in One Paragraph Every memory is an append-only JSON event stored in a private GitHub repository. A Python compiler runs via GitHub Actions on every push, processes those events, and outputs clean markdown files. At the start of each agent session, the agent reads those files via its system prompt. That's the entire system. ┌─────────────────────────────────────────────────────────┐ │ agent-soul repo │ │ │ │ sources/<agent-id>/YYYY-MM-DD.ndjson │ │ ── append-only event stream (what happened) │ │ │ │ canonical/ ←