agents-memory

Motor local de memoria en Markdown y contexto entre agentes para asistentes de codificación de IA.
Una identidad persistente, compartida entre Claude Code, Cursor, Antigravity y Zed.

¿Por qué .agents/memory?

El nombre agents-memory proviene directamente de su estándar de almacenamiento universal: .agents/memory.

• Global: ~/.agents/memory/ almacena tu identidad persistente, valores predeterminados de stack, conceptos duraderos e índice de proyectos.

• Repositorio: <repo>/.agents/memory/ almacena hechos específicos del repositorio, ADRs de arquitectura y bandejas de entrada de staging.

Mientras los proveedores de IA fragmentan su configuración en almacenes propietarios, .agents/ ofrece un hub de sistema de archivos único, abierto e independiente del proveedor para todas las configuraciones de agentes e inteligencia compartida.

agents-memory ofrece esto con una arquitectura puramente Markdown-first:

• Local y sin conexión: Tu identidad y la memoria del repositorio viven en archivos de texto plano (~/.agents/memory/ y <repo>/.agents/memory/).

• Legible para humanos y compatible con Git: Edita con cualquier editor de texto, haz diff con git, haz commit cuando quieras.

• Servidor MCP universal: Expone herramientas de memoria (search_memory, add_memory, get_project_memories, distill_batch) a todos los agentes modernos.

• Ingesta y destilación autónomas: Extrae reglas duraderas y decisiones de arquitectura de los registros de sesión (OpenAI, Claude, Cursor, Copilot, Antigravity, Pi).

Related MCP server: agent-julia

Arquitectura y flujo

 ┌─────────────────────────────────────────────────────────────┐
 │                       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 │
 └─────────────────────────────┘ └─────────────────────────────┘

Inicio rápido

Configuración en 1 paso

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

Genera la estructura de ~/.agents/memory/, conecta automáticamente las configuraciones MCP en tus IDEs instalados y registra las habilidades del asistente.

[!TIP] 🤖 Configuración impulsada por el agente (sin fricción):
Simplemente dile a tu agente de codificación: "Instala y configura agents-memory por mí."
El agente instala el paquete, pregunta tus preferencias de stack una vez, completa tu perfil USER.md y registra tus repositorios de forma autónoma.

Referencia de CLI

Ecosistema compatible

• Claude Code: Vinculado mediante symlink / AGENTS.md canónico y servidor MCP.

• Google Antigravity: Integrado mediante reglas de .gemini/config y MCP de agents-memory.

• Cursor: Inyecta reglas automáticamente y configura .cursor/mcp.json.

• Zed: Configura context_servers y replica las habilidades del asistente.

• VS Code / Copilot: Ingiere el historial de sesiones desde las bases de datos de estado locales.

También compatible con: Windsurf, Cline, Roo-Code, Aider, Continue.dev, OpenAI ChatGPT, Pi, Goose y cualquier asistente de IA compatible con MCP.

Especificación ABI abierta

La especificación formal de estructura independiente de la implementación se encuentra en abi/:

• abi/WHY.md — Decisiones de arquitectura y por qué Markdown gana frente a RAG.

• abi/LAYOUT.md — Taxonomía de directorios y contratos de rutas.

• abi/KINDS.md — Taxonomía de memoria tipada (concepts, facts, decisions).

• abi/MCP.md — Definiciones de herramientas y especificaciones de solicitud/respuesta.

• abi/INGEST.md — Pipeline de catálogo, extracción y destilación.

• abi/INJECTION.md — Mecanismos de inyección de reglas de host.

Pruebas y verificación

Ejecuta la suite de pruebas completa y el benchmark de destilación:

python tests/run_all_tests.py

Licencia

Licencia MIT. Consulta LICENSE para más detalles.