agent-memory

Lokaler Markdown-Speicher für Coding-Agenten – jeder Anbieter, jedes Werkzeug.

Ohne ein gemeinsames Layout besitzt jeder Anbieter einen Friedhof – Sitzungsarchive, die nie zu dauerhafter Identität werden, es sei denn, du bringst jedem neuen Agenten alles neu bei. Siehe abi/WHY.md für die vollständige Begründung (vs. RAG, vs. Tresore, vs. Anbieterspeicher). Roadmap der Referenzimplementierung: ROADMAP.md.

Dein Speicher lebt in Ordnern, die dir gehören: ~/.agents/memory (Identität + Projektkarte) und <repo>/.agents/memory (projektbezogene Arbeit). Dein Agent – oder jeder Host, der Markdown und optionales MCP liest – verwendet dasselbe Layout.

Markdown ist die Quelle der Wahrheit. Der Python-MCP in diesem Repository ist die Referenzimplementierung, kein proprietäres Backend.

ABI (stabiler Vertrag)

Ausgeliefert unter abi/ – versioniert, dokumentiert, implementierungsunabhängig:

Die Installation kopiert abi/LAYOUT.md → ~/.agents/memory/LAYOUT.md. Injektion und CLI-Flags: abi/INSTALL.md. Maschinenlesbar: python -m agent_memory --help-json.

Related MCP server: mcp-chest-memory

Referenzimplementierung (dieses Repository)

Python befindet sich in src/agent_memory/ (pip install -e . aus dem Klon).

Vorlagen nur in Git: examples/*.example.*. Live-Speicher: ~/.agents/memory. Führe python -m agent_memory consolidate aus, wenn Markdown in diesen Klon gelangt ist.

Coding-Agenten: Befolge AGENTS.md für die Installation.

Layout (Zusammenfassung)

Die Suche vereint Benutzer + alle registrierten Projektbäume. Chat-Inhalte bleiben in Produktordnern; chats-index.md enthält nur Titel + Pfade.

Einrichtung

Derselbe Interpreter für pip und MCP:

python -m pip install -e .
python -m agent_memory sync --init
python -m agent_memory inventory

Fülle ~/.agents/memory/USER.md und scan.json (aus examples/*.example.* beim ersten Lauf). Lade deinen Agenten nach dem MCP-Merge neu.

Siehe abi/PLATFORM.md für Windows-Symlink-Stubs und Hardlink-Fallback.

Skripte

python -m agent_memory inventory
python -m agent_memory inventory --json
python -m agent_memory inventory --register SLUG "/path/to/repo" "role" "stack"
python -m agent_memory sync
python -m agent_memory --help-json
python -m agent_memory sync --help-json
python -m agent_memory inventory --help-json
python -m agent_memory ingest catalog

Nach der Installation ist agent-memory im PATH dasselbe wie python -m agent_memory.