agents-memory

Lokale Markdown-Speicher- & Cross-Agent-Kontext-Engine für KI-Codierungsassistenten.
Eine persistente Identität, gemeinsam genutzt über Claude Code, Cursor, Antigravity und Zed.

Warum .agents/memory?

Der Name agents-memory stammt direkt von seinem universellen Speicherstandard: .agents/memory.

• Global: ~/.agents/memory/ speichert deine persistente Identität, Stack-Standardwerte, dauerhafte Konzepte und den Projektindex.

• Repository: <repo>/.agents/memory/ speichert repospezifische Fakten, Architektur-ADRs und Staging-Posteingänge.

Während KI-Anbieter ihre Konfiguration über proprietäre Speicher verteilen, bietet .agents/ einen einzigen, offenen, anbieterneutralen Dateisystem-Hub für alle Agent-Konfigurationen und gemeinsames Wissen.

agents-memory setzt dies mit einer reinen Markdown-First-Architektur um:

• Lokal & offline: Deine Identität und der Repo-Speicher leben in einfachen Dateien (~/.agents/memory/ und <repo>/.agents/memory/).

• Für Menschen lesbar & Git-freundlich: Bearbeite mit einem beliebigen Texteditor, diffe mit git und committe, wann du willst.

• Universeller MCP-Server: Stellt allen modernen Agenten Speicher-Tools (search_memory, add_memory, get_project_memories, distill_batch) bereit.

• Autonomes Ingest & Destillation: Extrahiert dauerhafte Regeln und Architekturentscheidungen aus Sitzungsprotokollen (OpenAI, Claude, Cursor, Copilot, Antigravity, Pi).

Related MCP server: agent-julia

Architektur & Ablauf

 ┌─────────────────────────────────────────────────────────────┐
 │                       SESSION INGEST                        │
 │  OpenAI Exports · Claude JSONL · Cursor · Antigravity · Pi  │
 └──────────────────────────────┬──────────────────────────────┘
                                │  ingest catalog / extract
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                       STAGING INBOX                         │
 │        Raw captured bullets & noise-filtered facts          │
 └──────────────────────────────┬──────────────────────────────┘
                                │  distill_batch / skill
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                     LOCAL MEMORY STORE                      │
 │   ~/.agents/memory/USER.md     ~/.agents/memory/PROJECTS.md │
 │   ~/.agents/memory/concepts/   <repo>/.agents/memory/       │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │       IDE INJECTION         │ │     MCP SERVER & CLERK      │
 │  Cursor Rules · Zed Context │ │  search_memory · add_memory │
 │  Antigravity AGENTS.md      │ │  Universal Tool Integration │
 └─────────────────────────────┘ └─────────────────────────────┘

Schnellstart

1-Schritt-Setup

pip install agents-memory && agents-memory sync --init

Erstellt das Grundgerüst von ~/.agents/memory/, verdrahtet MCP-Konfigurationen automatisch in deine installierten IDEs und registriert Assistenten-Fähigkeiten.

[!TIP] 🤖 Agentengesteuertes Setup (Null Reibung):
Sage deinem Codierungsagenten einfach: „Installiere und richte agents-memory für mich ein."
Der Agent installiert das Paket, fragt einmal nach deinen Stack-Präferenzen, füllt dein USER.md-Profil und registriert deine Repositories autonom.

CLI-Referenz

Unterstütztes Ökosystem

• Claude Code: Gebunden über Symlink / kanonische AGENTS.md und MCP-Server.

• Google Antigravity: Integriert über .gemini/config-Regeln und den agents-memory-MCP.

• Cursor: Injiziert automatisch Regeln und konfiguriert .cursor/mcp.json.

• Zed: Konfiguriert context_servers und spiegelt Assistenten-Fähigkeiten.

• VS Code / Copilot: Liest Sitzungsverläufe aus lokalen Zustandsdatenbanken ein.

Außerdem kompatibel mit: Windsurf, Cline, Roo-Code, Aider, Continue.dev, OpenAI ChatGPT, Pi, Goose und jedem MCP-konformen KI-Assistenten.

Offene ABI-Spezifikation

Die formale, implementationsagnostische Layout-Spezifikation befindet sich in abi/:

• abi/WHY.md — Architekturentscheidungen & warum Markdown gegenüber RAG gewinnt.

• abi/LAYOUT.md — Verzeichnis-Taxonomie und Pfadverträge.

• abi/KINDS.md — Typisierte Speicher-Taxonomie (concepts, facts, decisions).

• abi/MCP.md — Tool-Definitionen und Anfrage-/Antwort-Spezifikationen.

• abi/INGEST.md — Katalog-, Extraktions- und Destillations-Pipeline.

• abi/INJECTION.md — Mechanismen zur Injektion von Host-Regeln.

Tests & Verifizierung

Führe die umfassende Testsuite und den Destillations-Benchmark aus:

python tests/run_all_tests.py

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.