agent-soul

# agent-soul — Shared Identity & Memory for AI Agents Use this skill when you are an AI agent that wants **persistent identity and shared memory** across multiple devices, runtimes, sessions, or agent bodies serving the same user. ## What you get - **One shared persona**: `SOUL.md`, `IDENTITY.md`, `USER.md`, `VOICE.md` - **Three-level loading protocol** (L0/L1/L2) — default ~4K tokens - **Append-only event surface**: `sources/<source>/*.ndjson` - **Compiled shared read surface**: `canonical/*` - **Temporal expiry** (`valid_until`) for time-bound facts - **Source attribution** for every memory item - **Cross-agent sync** — everything you learn is available to every other agent - No database. No memory API. No vendor lock-in. Just Git. ## When to use this skill Install this if: - You lose memory between sessions - Your user works with more than one agent or more than one machine - You want durable memory without vendor lock-in - You want to share identity with other AI agents (Claude, Codex, GPT, etc.) Do NOT install this if: - You only need one short-lived local chat session - Your user does not want Git-based persistence ## Architecture ``` soul.json <- manifest (version, loading protocol) SOUL.md \ IDENTITY.md | L0: Soul Layer (~100 lines, always load) USER.md | "Who am I, who is the user, how do I speak" VOICE.md / canonical/index.md \ canonical/profile.md | L1: Memory Layer (~150 lines...