agent-memory
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:
Doc | What |
Übersicht + Konformität | |
Warum es das gibt (vs. RAG, Tresore, Anbieterfriedhöfe) | |
Roadmap der Referenzimplementierung (nicht ABI) | |
Ordner-Taxonomie | |
Wohin Fakten gehören | |
Tool-Vertrag | |
AGENTS / CLAUDE-Bindung | |
Windows, Symlinks, maschinenspezifische Pfade | |
Sync, Injektion, scan.json, | |
Katalog / Extraktion / Destillations-Pipeline |
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: RepoRecall
Referenzimplementierung (dieses Repository)
Python befindet sich in src/agent_memory/ (pip install -e . aus dem Klon).
Piece | Role |
| MCP: Suche / Hinzufügen / Registrieren / Inventar / Sync / Ingest |
| Layout-Engine, Taxonomie, Injektion |
| Kanonische |
| Festplatte vs. |
| Chat-Katalog + Extraktions-Pipeline |
| Agent-Installations-Skill |
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)
Path | What |
| Immer aktive Identität |
| slug / Pfad / Rolle / Stack / Status |
| Querschnittlicher typisierter Speicher (beim ersten Schreiben erstellt) |
| Link zum echten Baum (keine Kopie) |
| Dateien nur bei Verwendung – Staging-Posteingang, dann typisierte Pfade beim Schreiben |
| Kurze Injektion; |
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 inventoryFü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 catalogNach der Installation ist agent-memory im PATH dasselbe wie python -m agent_memory.
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP memory for coding agents: persistent across sessions, editable markdown, team sharing.
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides portable memory for AI agents using plain Markdown files. Enables storing, recalling, and managing memories via MCP tools like recall, remember, forget, list, and get.3 npm1MIT
- AlicenseNot gradedqualityBmaintenanceProvides persistent, local-first memory for coding agents with Markdown as the source of truth, exposed via CLI, loopback API, MCP, and Codex hooks for context retrieval and durable writes.MIT
- AlicenseNot gradedqualityAmaintenanceA local markdown memory and cross-agent context engine for AI coding assistants. It provides an MCP server with tools to search, add, retrieve, and distill persistent memory across tools like Claude Code, Cursor, and Zed.165 PyPI5MIT
- AlicenseNot gradedqualityAmaintenanceProvides persistent, shared memory for AI agents via MCP, enabling retrieval of relevant memories instead of loading entire context. Allows agents across projects, machines, and tools to share a single auditable, markdown-native brain.3AGPL 3.0