Skip to main content
Glama
deenesjakoruzh
Lolaplex

agent-memory

by Lolaplex
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

agent-memory

Memoria local en markdown para agentes de codificación: cualquier proveedor, cualquier herramienta.

Sin un diseño compartido, cada proveedor posee un cementerio: archivos de sesión que nunca se convierten en identidad duradera a menos que re-enseñes a cada nuevo agente. Consulta abi/WHY.md para ver la justificación completa (frente a RAG, frente a bóvedas, frente a la memoria del proveedor). Hoja de ruta de la implementación de referencia: ROADMAP.md.

Tu memoria vive en carpetas que tú posees: ~/.agents/memory (identidad + mapa de proyectos) y <repo>/.agents/memory (trabajo por proyecto). Tu agente —o cualquier host que lea markdown y MCP opcional— usa el mismo diseño.

Markdown es la fuente de verdad. El MCP de Python en este repositorio es la implementación de referencia, no un backend propietario.

ABI (contrato estable)

Incluido en abi/ — versionado, documentado, independiente de la implementación:

Documento

Qué contiene

abi/README.md

Resumen + conformidad

abi/WHY.md

Por qué existe esto (frente a RAG, bóvedas, tumbas de proveedores)

ROADMAP.md

Hoja de ruta de la implementación de referencia (no ABI)

abi/LAYOUT.md

Taxonomía de carpetas

abi/KINDS.md

Dónde van los hechos

abi/MCP.md

Contrato de herramientas

abi/INJECTION.md

Vinculación AGENTS / CLAUDE

abi/PLATFORM.md

Windows, symlinks, rutas por máquina

abi/INSTALL.md

Sincronización, inyección, scan.json, --help-json

abi/INGEST.md

Pipeline de catálogo / extracción / destilación

La instalación copia abi/LAYOUT.md → ~/.agents/memory/LAYOUT.md. Inyección y banderas de CLI: abi/INSTALL.md. Legible por máquina: python -m agent_memory --help-json.

Related MCP server: RepoRecall

Implementación de referencia (este repositorio)

Python vive en src/agent_memory/ (pip install -e . desde el clon).

Pieza

Rol

agent_memory.mcp_server

MCP: search / add / register / inventory / sync / ingest

agent_memory.store

Motor de diseño, taxonomía, inyección

python -m agent_memory sync

~/.agents/AGENTS.md canónico, CLAUDE.md vinculado, inyección del host

python -m agent_memory inventory

Disco vs PROJECTS.md (omite .agents, .cursor)

python -m agent_memory ingest

Pipeline de catálogo de chat + extracción

skills/memory-sync/

Habilidad de instalación del agente

Plantillas solo en git: examples/*.example.*. Almacén activo: ~/.agents/memory. Ejecuta python -m agent_memory consolidate si markdown se filtró a este clon.

Agentes de codificación: sigue AGENTS.md para la instalación.

Diseño (resumen)

Ruta

Qué contiene

~/.agents/memory/USER.md

Identidad siempre activa

~/.agents/memory/PROJECTS.md

slug / ruta / rol / stack / estado

~/.agents/memory/concepts/ …

Memoria tipada transversal (creada en la primera escritura)

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

Enlace al árbol real (no una copia)

<repo>/.agents/memory/

Archivos solo cuando se usan — bandeja de entrada de staging, luego rutas tipadas al escribir

~/.agents/AGENTS.md

Inyección corta; CLAUDE.md vinculado a ella

La búsqueda une el usuario + todos los árboles de proyectos registrados. Los cuerpos de chat permanecen en carpetas de producto; chats-index.md es solo títulos + rutas.

Configuración

Mismo intérprete para pip y MCP:

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

Rellena ~/.agents/memory/USER.md y scan.json (desde examples/*.example.* en la primera ejecución). Recarga tu agente después de la fusión MCP.

Consulta abi/PLATFORM.md para stubs de symlink de Windows y respaldo de hardlink.

Scripts

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

Después de la instalación, agent-memory en PATH es lo mismo que python -m agent_memory.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • mnemo

    cniackz
    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

  • RepoRecall

    esannkv
    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

  • agents-memory

    Lolaplex
    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

  • marrow

    aryawidjaja
    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