Claude-Mem: memoria persistente y local para sesiones de agentes

Todo lo que hay que saber sobre thedotmack/claude-mem: un motor de memoria que observa el trabajo de un agente, lo resume y devuelve contexto relevante en sesiones posteriores.

Qué es Claude-Mem

Claude-Mem es un plugin y motor de memoria persistente para asistentes de programación. Su función principal es evitar que una sesión nueva empiece sin el contexto de las anteriores: captura observaciones de uso de herramientas, genera resúmenes semánticos y los vuelve a inyectar cuando resulta pertinente.

El núcleo de código abierto se instala localmente y guarda datos en SQLite; el proyecto añade búsqueda híbrida con Chroma, un servicio local en Bun y herramientas MCP. Por tanto, no es solo un archivo de instrucciones para Claude Code: es una combinación de enganches del ciclo de vida, proceso de fondo, bases de datos y una interfaz de consulta. El README y la documentación oficial también describen compatibilidad con Cursor, Windsurf, OpenCode, Codex CLI, Gemini CLI, Antigravity CLI, OpenClaw y clientes MCP.

La web del proyecto distingue el motor local gratuito, bajo Apache-2.0, de CMEM Cloud, un servicio de sincronización y enlace MCP privado. La suscripción anunciada en la web es de 20 USD al mes; no es un requisito para usar el motor local.

El origen: resolver el reinicio de contexto

El autor identificado por el README es Alex Newman (thedotmack, cuenta oficial de X: @Claude_Memory). La primera evidencia de lanzamiento recuperada es una publicación de Newman en Hacker News del 23 de octubre de 2025, titulada en español «Construí un plugin de gestión de contexto y me cambió la vida», que enlazaba un hilo de r/ClaudeCode. El envío obtuvo 11 puntos y un comentario (HN 45676686).

La narrativa del proyecto parte de una limitación cotidiana de las sesiones de agentes: el trabajo de exploración, decisiones, errores y correcciones se pierde al cerrar o reconectar. En diciembre de 2025, Newman anunció en X la disponibilidad de Cursor-Mem en Claude-Mem 8.5.0; el enlace de ese anuncio fue recogido en HN 46429613, con 2 puntos y un comentario. Es una señal de que Cursor fue una extensión temprana, no una confirmación de apoyo oficial de Cursor.

Desde entonces el alcance se amplió: la página de integraciones de cmem.ai incluye más agentes, clientes MCP y capturas de transcripciones. La expansión plantea una tensión práctica: una memoria que ayuda a no repetir explicaciones puede también almacenar información que el usuario no desea propagar. De ahí que el README incluya etiquetas <private> para excluir contenido y que la versión 13.13.0 introdujera un tipo de observación sensitive.

Filosofía y principios

La documentación presenta cinco ideas que sostienen el diseño:

Continuidad sin intervención manual: los enganches capturan eventos y el contexto relevante reaparece automáticamente al iniciar o continuar sesiones.
Divulgación progresiva: primero se obtiene un índice compacto; el detalle se recupera únicamente para los identificadores elegidos. El README estima un ahorro cercano a diez veces frente a traer todas las observaciones.
Búsqueda por significado y por texto: combina FTS5 de SQLite con Chroma para unir coincidencia textual y recuperación semántica.

Visualización de búsqueda híbrida: bloques de texto FTS5 fusionándose con un espacio vectorial de Chroma en un único haz de resultados.

Control local y privacidad: la instalación local conserva los datos en la máquina; <private> permite excluir fragmentos. La sincronización en la nube es una oferta separada.

Bóveda local de SQLite protegida por un candado, con una etiqueta <private> bloqueando fragmentos de datos frente a un icono de CMEM Cloud.

Integración mediante estándares y adaptadores: MCP permite que otros clientes consulten la memoria, mientras que los adaptadores de cada entorno instalan los enganches necesarios.

Estas son afirmaciones de diseño del proyecto, no una auditoría independiente de la calidad de las respuestas ni de los ahorros de tokens.

Embudo de divulgación progresiva: un flujo masivo de datos en bruto se reduce a un índice compacto y solo se expanden los identificadores seleccionados, representando una reducción de diez veces.

Cómo funciona

El flujo documentado tiene cuatro piezas principales:

Captura: seis guiones asociados a cinco etapas del ciclo de vida —SessionStart, UserPromptSubmit, PostToolUse, Stop y SessionEnd— observan la actividad del agente. El instalador también utiliza una comprobación previa de dependencias, que no es un enganche de ciclo de vida.

Cinco nodos de neón representando los enganches del ciclo de vida SessionStart, UserPromptSubmit, PostToolUse, Stop y SessionEnd, conectados por flujos de datos luminosos.

Procesamiento y almacenamiento: un proceso local administrado por Bun registra sesiones, observaciones y resúmenes en SQLite. Chroma aporta el índice vectorial para búsqueda semántica. La interfaz web del trabajador muestra el flujo de memoria en tiempo real.
Recuperación: las herramientas MCP siguen una secuencia de tres capas. search devuelve un índice barato de resultados; timeline sitúa una observación en su cronología; get_observations obtiene el contenido completo de una lista de identificadores. El README también menciona mem-search, una habilidad para consultas en lenguaje natural.

Sistema de recuperación en tres capas: barras de neón apiladas para las herramientas MCP search, timeline y get_observations, con datos fluyendo entre ellas.

Inyección y uso posterior: en la siguiente sesión, el plugin selecciona y añade contexto de acuerdo con la configuración. El usuario puede consultar el historial en vez de depender exclusivamente de esa inyección automática.

La documentación oficial enumera Node.js 20 o superior, una versión reciente de Claude Code con soporte de plugins, Bun, uv y SQLite 3; el instalador intenta proporcionar Bun y uv si faltan. Para otros entornos, el requisito exacto depende del adaptador correspondiente.

Estado oficial y semioficial

Claude-Mem es un proyecto independiente de thedotmack. En las fuentes recuperadas no aparece una aceptación, certificación o respaldo por Anthropic, OpenAI, Cursor, Google o Microsoft. Que se instale desde Claude Code mediante /plugin marketplace add thedotmack/claude-mem y /plugin install claude-mem acredita un mecanismo de distribución compatible con ese mercado, no una certificación del proveedor.

Su estado semioficial es más claro dentro de su propia oferta: cmem.ai presenta Claude-Mem como el motor abierto que respalda CMEM Cloud y enlaza documentación, cambios, Discord y repositorio. La interoperabilidad con MCP es una compatibilidad técnica; no convierte a Claude-Mem en parte oficial de cada cliente MCP mencionado.

El ecosistema

Proyecto, servicio y documentación

thedotmack/claude-mem: repositorio principal, motor local, plugins y adaptadores.
CMEM Cloud / cmem.ai: servicio comercial opcional de sincronización; anuncia una base de observaciones replicada y un enlace MCP privado para clientes autorizados.
ragtime/ dentro del repositorio: componente con licencia Apache-2.0 según el README. No se recuperó evidencia suficiente para describirlo como repositorio independiente.
workers/sync-hub, cursor-hooks, openclaw, plugin y docs aparecen como directorios del repositorio principal. Indican que la distribución reúne adaptadores y servicio de sincronización en el mismo árbol, no varios repositorios oficiales separados.

Mapa del ecosistema con Claude-Mem como núcleo hexagonal central, conectado por líneas de neón a nodos de Cursor, Windsurf, OpenCode y otros clientes.

Puertos, extensiones y bifurcaciones encontradas

La búsqueda del registro npm recuperó extensiones que se declaran compatibles o derivadas de Claude-Mem. Se nombran como proyectos comunitarios; no se infiere patrocinio del autor:

Ephemushroom/opencode-claude-mem (@ephemushroom/opencode-claude-mem): plugin para OpenCode; el registro npm mostraba 84 descargas semanales y versión 0.4.4.
mc303/claude-mem-opencode: integración con OpenCode; 30 descargas semanales y versión 0.1.4 en npm.
bloodf/opencode-mem (@bloodf/opencode-claude-mem): adaptador de OpenCode; 22 descargas semanales y versión 1.2.0.
ManuelStaggl/keepmind: se describe como bifurcación de Claude-Mem solo para Node; 621 descargas semanales y versión 3.3.2.
sdsrss/claude-mem-lite: alternativa ligera basada en SQLite, FTS5 y TF-IDF; su descripción la presenta explícitamente como alternativa de menor coste, no como una rama oficial; 1.728 descargas semanales y versión 3.59.1.
rumitvn/tre-mem: capa lateral de memoria compartida y consciente de ramas sobre Claude-Mem; 67 descargas semanales y versión 0.11.3.
pencil-agent/pencil-mem: puerto para nanopencil, según el registro; 10 descargas semanales y versión 0.1.2.
ArtemisAI/pi-mem (pi-agent-memory): extensión para agentes Pi que declara estar impulsada por Claude-Mem; 24 descargas semanales y versión 0.3.4.

Además, el README enlaza traducciones del propio proyecto al chino simplificado y tradicional, japonés, portugués, coreano, español, alemán, francés, hebreo, árabe, ruso, polaco, checo, neerlandés, turco, ucraniano, vietnamita, tagalo, indonesio, tailandés, hindi, bengalí, urdu, rumano, sueco, italiano, griego, húngaro, finés, danés y noruego. Esas páginas son documentación traducida, no repositorios de traducción separados.

Números del repositorio

Medición: 5 de agosto de 2026, página pública de GitHub y npm.

Métrica	Valor recuperado
Estrellas	89,7 mil
Bifurcaciones	7,8 mil
Commits visibles	2.378
Ramas visibles	411
Etiquetas visibles	324
Incidencias abiertas visibles	209
Solicitudes de cambios abiertas visibles	149
Última versión	`v13.13.1`, 3 de agosto de 2026
Paquete npm	`claude-mem` 13.13.1
Descargas npm semanales	12.620
Descargas npm mensuales	64.123
Licencia	Apache-2.0

Panel de GitHub con métricas en neón: 89,7 mil estrellas, 7,8 mil bifurcaciones y la versión v13.13.1, sobre un grafo de contribuidores y ramas.

GitHub devolvió límite de tasa para los extremos de API durante esta medición; por ello las cifras de estrellas, bifurcaciones, ramas, etiquetas, commits, incidencias y solicitudes de cambios son las visibles en la página pública, no una extracción de API. No se recuperaron los suscriptores reales ni un ranking fiable de contribuidores, así que se omiten. La cifra de incidencias de la interfaz está separada de las solicitudes de cambios en esa página; el campo open_issues_count de la API, cuando está disponible, puede mezclar ambos conceptos.

La versión 13.13.1 añade el flujo interactivo /mode-creator, que crea un modo personalizado a partir del dominio y las necesidades de toma de notas del usuario. La 13.13.0 añade el tipo sensitive y avisos configurables de Telegram. Son cambios descritos por el proyecto en su changelog.

Cómo contribuir

El README establece un flujo convencional y verificable: bifurcar el repositorio, crear una rama de funcionalidad, cambiar con pruebas, actualizar documentación y abrir una solicitud de cambios. También documenta tres ramas de publicación: main para versiones estables publicadas en npm, y core-dev y community-edge para ejecutar desde fuente correcciones tempranas e integraciones comunitarias.

Hay señales de una disciplina de revisión intensa. El changelog de 13.12.2 indica que se evaluaron 157 solicitudes abiertas con una rúbrica pública en docs/merge-rubric.md; la 13.12.4 declara 2.539 pruebas aprobadas y ninguna fallida para su ciclo de correcciones. Son resultados y reglas del propio mantenedor, no una verificación externa.

Guía rápida de uso

Instalación y primer arranque

Instalar para Claude Code:
```
npx claude-mem install
```

O instalar desde el mercado de plugins dentro de Claude Code:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Reiniciar Claude Code. Según el README, las observaciones de sesiones previas empezarán a aparecer automáticamente en sesiones nuevas.

Terminal ejecutando el comando de instalación npx claude-mem install junto a un diagrama de ramas Git mostrando main, core-dev y community-edge.

Para OpenCode, el comando documentado es npx claude-mem install --ide opencode; para Antigravity CLI, npx claude-mem install --ide antigravity. No usar npm install -g claude-mem para el primer arranque: el README aclara que instala la biblioteca, pero no registra los enganches ni configura el trabajador.

Flujos de trabajo habituales

Buscar una decisión o error anterior: ejecutar search(query="authentication bug", type="bugfix", limit=10), revisar el índice y pedir el detalle con get_observations(ids=[123, 456]). Los identificadores son ejemplos del README; deben sustituirse por los devueltos por la búsqueda.
Reconstruir la secuencia de un cambio: usar timeline alrededor de una observación encontrada para recuperar el contexto cronológico sin cargar todo el historial.
Consultar la memoria desde un cliente MCP: conectar el cliente compatible y usar las herramientas search, timeline y get_observations. La página de integraciones enumera Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Codex CLI, Gemini CLI y VS Code.
Excluir datos sensibles: envolver el contenido que no debe almacenarse con las etiquetas <private> documentadas por el README.

Configuración esencial

El primer archivo que modifica una instalación de Claude Code es ~/.claude-mem/settings.json, creado con valores predeterminados. La documentación indica que concentra, entre otros, estos ajustes:

modelo o proveedor de IA;
puerto del trabajador local;
directorio de datos;
nivel de registro;
reglas de inyección de contexto;
CLAUDE_MEM_MODE, que selecciona modo y lenguaje de las observaciones, por ejemplo code--zh;
CLAUDE_MEM_TELEGRAM_TRIGGER_TYPES, que controla qué tipos disparan avisos de Telegram.

Tras cambiar CLAUDE_MEM_MODE, el README pide reiniciar Claude Code. Los modos se guardan en plugin/modes/; la ruta local documentada para inspeccionarlos es ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/.

Trampas frecuentes y soluciones

El comando npm no existe en Windows: el README atribuye el error a Node.js/npm ausentes del PATH. Instalar Node.js, reiniciar la terminal y repetir la instalación.
Se instaló el paquete global pero no funciona el plugin: sustituir npm install -g claude-mem por npx claude-mem install o por los comandos de mercado, porque el paquete global no activa los enganches ni el trabajador.
Bucle de reinicio del trabajador tras actualizar: el changelog de 13.12.3 documenta que versiones anteriores podían recrear un proceso antiguo ante una discrepancia de versión. La solución publicada es actualizar; el primer enganche de la versión corregida termina el proceso obsoleto y toma el control.
Datos que no deben reaparecer: usar <private> antes de que se capture el contenido. Para información que no es estrictamente privada pero no debe filtrarse en futuras elaboraciones, revisar el tipo sensitive y las notificaciones añadidos en 13.13.0.
Directrices del mantenedor incluidas accidentalmente en instalaciones de mercado: la nota de 13.12.4 explica que se corrigió moviendo notas locales a CLAUDE.local.md. Mantenerse en una versión actual reduce la exposición a ese fallo histórico.

Integraciones y migración

El camino de migración más directo desde una instalación de Claude Code es instalar el adaptador del nuevo entorno con --ide cuando exista y conservar la configuración local. Para otros clientes, la interoperabilidad se apoya en MCP y en las herramientas de búsqueda. CMEM Cloud añade sincronización entre máquinas y un enlace MCP privado, pero es opcional y de pago.

Las extensiones comunitarias de OpenCode, Pi y nanopencil muestran rutas alternativas, aunque su compatibilidad y mantenimiento deben verificarse en cada proyecto. No se recuperó una guía oficial que prometa una migración automática desde Mem0, Zep, Letta, LangMem, Cognee, OpenAI Memory o Supermemory; la web los lista como comparativas, no como procedimientos de importación.

Cómo lo recibió la comunidad

La recepción recuperable en Hacker News es pequeña frente a las cifras de GitHub:

HN 47558167, enviado por perelin el 28 de marzo de 2026, enlazó directamente el repositorio bajo el título Claude-Mem. Alcanzó 2 puntos y 1 comentario. El registro describe el producto como captura automática de la actividad de Claude, compresión mediante el SDK de agentes e inyección de contexto en futuras sesiones. Es una presentación descriptiva, no una evaluación independiente positiva.
HN 46229436, enviado por handfuloflight el 11 de diciembre de 2025, enlazó el mismo repositorio y tuvo 1 punto y 0 comentarios. Acredita descubrimiento temprano, pero no consenso comunitario.
HN 45676686, de thedotmack, recibió 11 puntos y 1 comentario al enlazar la publicación de r/ClaudeCode sobre el plugin de gestión de contexto. El contenido de Reddit no pudo recuperarse de forma automatizada porque la página devolvió un enlace de incidencias; por eso no se atribuyen opiniones de Reddit que no se hayan podido leer.
HN 46429613, también de thedotmack, enlazó el anuncio de X para Cursor-Mem/Claude-Mem 8.5.0: 2 puntos y 1 comentario. X no permitió recuperar el contenido directo sin autenticación; se conserva solo el título, enlace y métrica servidos por HN.

La crítica técnica más concreta recuperada procede del propio changelog, no de un tercero: 13.12.4 reconoce que directrices internas del mantenedor habían llegado a instalaciones de mercado y podían ser obedecidas por instancias de usuario. El proyecto movió ese material a CLAUDE.local.md. También documentó fallos de puertos bloqueados, migraciones con claves foráneas y bucles de trabajador. Son correcciones de mantenimiento, no pruebas de que el sistema sea inseguro en su versión actual.

Se intentaron búsquedas en HN por nombre, autor y Cursor-Mem; Reddit directo; X a través del anuncio enlazado; YouTube; Product Hunt; Dev.to/Hashnode; podcasts y listas curadas. En esta ejecución no se recuperaron reseñas verificables, vídeos, lanzamiento de Product Hunt, menciones de newsletter o hilos directos en esos canales. La ausencia de material recuperado no mide la calidad ni descarta su existencia.

Claude-Mem frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable o límite
`sdsrss/claude-mem-lite`	Ambos ofrecen memoria persistente para Claude Code.	El paquete se presenta como alternativa más ligera, con una sola base SQLite y FTS5 + TF-IDF; Claude-Mem documenta además Chroma y un trabajador Bun.
`ManuelStaggl/keepmind`	El registro npm la describe como bifurcación de Claude-Mem para persistir contexto.	Keepmind se declara una bifurcación solo para Node; no se recuperó una comparación de funciones mantenida por ambos proyectos.
`rumitvn/tre-mem`	Se apoya en Claude-Mem como capa de memoria para agentes de programación.	Tre-mem se posiciona como capa lateral compartida y consciente de ramas; ese enfoque no se describe como función principal del núcleo de Claude-Mem.
Mem0, Zep, Letta, LangMem, Cognee, OpenAI Memory y Supermemory	La web de CMEM lista páginas comparativas con todos ellos.	No se recuperaron esas comparativas ni métricas de pruebas equivalentes; no se afirma superioridad funcional.

Casos de uso y a quién puede ayudar este repositorio

Desarrolladores que alternan sesiones largas de Claude Code: los enganches, SQLite, resúmenes e inyección de contexto buscan conservar decisiones, diagnósticos y trabajo exploratorio al reiniciar la sesión.
Equipos o personas que cambian entre terminal, IDE y agentes: el soporte MCP y los adaptadores documentados para Cursor, OpenCode, Codex CLI, Gemini CLI, Windsurf y OpenClaw ofrecen una vía para consultar la misma memoria desde más de una herramienta; CMEM Cloud amplía eso a sincronización entre máquinas si se contrata.
Personas que investigan una base de código grande: el patrón search → timeline → get_observations permite localizar un hecho y ampliar solo el contexto necesario, en lugar de cargar toda la memoria de una vez.
Usuarios con requisitos de privacidad o trazabilidad: las etiquetas <private>, el almacenamiento local y el tipo sensitive dan controles explícitos, aunque requieren que el usuario etiquete el material y revise su configuración.
Mantenedores de integraciones de agentes: los adaptadores de comunidad para OpenCode, Pi y nanopencil y el protocolo MCP muestran cómo extender el motor, pero esas extensiones no equivalen a soporte oficial y deben evaluarse por separado.

Recursos

Repositorio: https://github.com/thedotmack/claude-mem
Documentación e instalación: https://docs.claude-mem.ai/introduction
Arquitectura y búsqueda: https://docs.claude-mem.ai/introduction
Cambios oficiales: https://cmem.ai/changelog
Integraciones: https://cmem.ai/integrations
Paquete y métricas npm: https://www.npmjs.com/package/claude-mem
Servicio CMEM Cloud: https://cmem.ai/
Comunidad Discord: https://discord.gg/J4wttp9vDu
Conversaciones HN: https://news.ycombinator.com/item?id=47558167, https://news.ycombinator.com/item?id=46229436, https://news.ycombinator.com/item?id=45676686, https://news.ycombinator.com/item?id=46429613
Anuncio de X enlazado por HN: https://twitter.com/Claude_Memory/status/2005856998919700833

Nota: este artículo combina el README, la documentación y web oficial de Claude-Mem/CMEM, las páginas públicas de GitHub, el registro npm y resultados de Hacker News consultados el 5 de agosto de 2026. Las métricas cambian con el tiempo; las limitaciones de acceso se indican donde afectan a los datos.