Skip to main content
Glama

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

abi/README.md

Übersicht + Konformität

abi/WHY.md

Warum es das gibt (vs. RAG, Tresore, Anbieterfriedhöfe)

ROADMAP.md

Roadmap der Referenzimplementierung (nicht ABI)

abi/LAYOUT.md

Ordner-Taxonomie

abi/KINDS.md

Wohin Fakten gehören

abi/MCP.md

Tool-Vertrag

abi/INJECTION.md

AGENTS / CLAUDE-Bindung

abi/PLATFORM.md

Windows, Symlinks, maschinenspezifische Pfade

abi/INSTALL.md

Sync, Injektion, scan.json, --help-json

abi/INGEST.md

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

agent_memory.mcp_server

MCP: Suche / Hinzufügen / Registrieren / Inventar / Sync / Ingest

agent_memory.store

Layout-Engine, Taxonomie, Injektion

python -m agent_memory sync

Kanonische ~/.agents/AGENTS.md, gebundene CLAUDE.md, Host-Injektion

python -m agent_memory inventory

Festplatte vs. PROJECTS.md (überspringt .agents, .cursor)

python -m agent_memory ingest

Chat-Katalog + Extraktions-Pipeline

skills/memory-sync/

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

~/.agents/memory/USER.md

Immer aktive Identität

~/.agents/memory/PROJECTS.md

slug / Pfad / Rolle / Stack / Status

~/.agents/memory/concepts/ …

Querschnittlicher typisierter Speicher (beim ersten Schreiben erstellt)

~/.agents/memory/projects/<slug>/

Link zum echten Baum (keine Kopie)

<repo>/.agents/memory/

Dateien nur bei Verwendung – Staging-Posteingang, dann typisierte Pfade beim Schreiben

~/.agents/AGENTS.md

Kurze Injektion; CLAUDE.md daran gebunden

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides 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 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides 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
  • A
    license
    Not graded
    quality
    A
    maintenance
    A 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 PyPI
    5
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides 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.
    3
    AGPL 3.0