🌐 Esta es una traducción automática. ¡Las correcciones de la comunidad son bienvenidas!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Sistema de compresión de memoria persistente construido para Claude Code.
Inicio Rápido • Cómo Funciona • Herramientas de Búsqueda • Documentación • Configuración • Solución de Problemas • Licencia
Claude-Mem preserva el contexto sin interrupciones entre sesiones al capturar automáticamente observaciones de uso de herramientas, generar resúmenes semánticos y ponerlos a disposición de sesiones futuras. Esto permite a Claude mantener la continuidad del conocimiento sobre proyectos incluso después de que las sesiones terminen o se reconecten.
Inicia una nueva sesión de Claude Code en la terminal e ingresa los siguientes comandos:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticamente en nuevas sesiones.
Características Principales:
- 🧠 Memoria Persistente - El contexto sobrevive entre sesiones
- 📊 Divulgación Progresiva - Recuperación de memoria en capas con visibilidad del costo de tokens
- 🔍 Búsqueda Basada en Habilidades - Consulta el historial de tu proyecto con la habilidad mem-search
- 🖥️ Interfaz de Visor Web - Transmisión de memoria en tiempo real en http://localhost:37777
- 💻 Habilidad para Claude Desktop - Busca en la memoria desde conversaciones de Claude Desktop
- 🔒 Control de Privacidad - Usa etiquetas
<private>para excluir contenido sensible del almacenamiento - ⚙️ Configuración de Contexto - Control detallado sobre qué contexto se inyecta
- 🤖 Operación Automática - No se requiere intervención manual
- 🔗 Citas - Referencias a observaciones pasadas con IDs (accede vía http://localhost:37777/api/observation/{id} o visualiza todas en el visor web en http://localhost:37777)
- 🧪 Canal Beta - Prueba características experimentales como Endless Mode mediante cambio de versión
📚 Ver Documentación Completa - Navegar en el sitio web oficial
- Guía de Instalación - Inicio rápido e instalación avanzada
- Guía de Uso - Cómo funciona Claude-Mem automáticamente
- Herramientas de Búsqueda - Consulta el historial de tu proyecto con lenguaje natural
- Características Beta - Prueba características experimentales como Endless Mode
- Ingeniería de Contexto - Principios de optimización de contexto para agentes de IA
- Divulgación Progresiva - Filosofía detrás de la estrategia de preparación de contexto de Claude-Mem
- Descripción General - Componentes del sistema y flujo de datos
- Evolución de la Arquitectura - El viaje de v3 a v5
- Arquitectura de Hooks - Cómo Claude-Mem usa hooks de ciclo de vida
- Referencia de Hooks - 7 scripts de hooks explicados
- Servicio Worker - API HTTP y gestión de Bun
- Base de Datos - Esquema SQLite y búsqueda FTS5
- Arquitectura de Búsqueda - Búsqueda híbrida con base de datos vectorial Chroma
- Configuración - Variables de entorno y ajustes
- Desarrollo - Compilación, pruebas y contribución
- Solución de Problemas - Problemas comunes y soluciones
Componentes Principales:
- 5 Hooks de Ciclo de Vida - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hooks)
- Instalación Inteligente - Verificador de dependencias en caché (script pre-hook, no un hook de ciclo de vida)
- Servicio Worker - API HTTP en el puerto 37777 con interfaz de visor web y 10 endpoints de búsqueda, gestionado por Bun
- Base de Datos SQLite - Almacena sesiones, observaciones, resúmenes
- Habilidad mem-search - Consultas en lenguaje natural con divulgación progresiva
- Base de Datos Vectorial Chroma - Búsqueda híbrida semántica + palabras clave para recuperación inteligente de contexto
Ver Descripción General de la Arquitectura para más detalles.
Claude-Mem proporciona búsqueda inteligente a través de la habilidad mem-search que se invoca automáticamente cuando preguntas sobre trabajo previo:
Cómo Funciona:
- Simplemente pregunta naturalmente: "¿Qué hicimos en la última sesión?" o "¿Arreglamos este error antes?"
- Claude invoca automáticamente la habilidad mem-search para encontrar contexto relevante
Operaciones de Búsqueda Disponibles:
- Search Observations - Búsqueda de texto completo en observaciones
- Search Sessions - Búsqueda de texto completo en resúmenes de sesiones
- Search Prompts - Búsqueda de solicitudes de usuario sin procesar
- By Concept - Buscar por etiquetas de concepto (discovery, problem-solution, pattern, etc.)
- By File - Buscar observaciones que referencian archivos específicos
- By Type - Buscar por tipo (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Obtener contexto de sesión reciente para un proyecto
- Timeline - Obtener línea de tiempo unificada de contexto alrededor de un punto específico en el tiempo
- Timeline by Query - Buscar observaciones y obtener contexto de línea de tiempo alrededor de la mejor coincidencia
- API Help - Obtener documentación de la API de búsqueda
Ejemplos de Consultas en Lenguaje Natural:
"What bugs did we fix last session?" "How did we implement authentication?" "What changes were made to worker-service.ts?" "Show me recent work on this project" "What was happening when we added the viewer UI?"
Ver Guía de Herramientas de Búsqueda para ejemplos detallados.
Claude-Mem ofrece un canal beta con características experimentales como Endless Mode (arquitectura de memoria biomimética para sesiones extendidas). Cambia entre versiones estables y beta desde la interfaz del visor web en http://localhost:37777 → Settings.
Ver Documentación de Características Beta para detalles sobre Endless Mode y cómo probarlo.
- Node.js: 18.0.0 o superior
- Claude Code: Última versión con soporte de plugins
- Bun: Runtime de JavaScript y gestor de procesos (se instala automáticamente si falta)
- uv: Gestor de paquetes de Python para búsqueda vectorial (se instala automáticamente si falta)
- SQLite 3: Para almacenamiento persistente (incluido)
Los ajustes se gestionan en ~/.claude-mem/settings.json (se crea automáticamente con valores predeterminados en la primera ejecución). Configura el modelo de IA, puerto del worker, directorio de datos, nivel de registro y ajustes de inyección de contexto.
Ver la Guía de Configuración para todos los ajustes disponibles y ejemplos.
Ver la Guía de Desarrollo para instrucciones de compilación, pruebas y flujo de contribución.
Si experimentas problemas, describe el problema a Claude y la habilidad troubleshoot diagnosticará automáticamente y proporcionará soluciones.
Ver la Guía de Solución de Problemas para problemas comunes y soluciones.
Crea reportes de errores completos con el generador automático:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
¡Las contribuciones son bienvenidas! Por favor:
- Haz fork del repositorio
- Crea una rama de característica
- Realiza tus cambios con pruebas
- Actualiza la documentación
- Envía un Pull Request
Ver Guía de Desarrollo para el flujo de contribución.
Este proyecto está licenciado bajo la GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Todos los derechos reservados.
Ver el archivo LICENSE para detalles completos.
Lo Que Esto Significa:
- Puedes usar, modificar y distribuir este software libremente
- Si modificas y despliegas en un servidor de red, debes hacer tu código fuente disponible
- Los trabajos derivados también deben estar licenciados bajo AGPL-3.0
- NO hay GARANTÍA para este software
Nota sobre Ragtime: El directorio ragtime/ está licenciado por separado bajo la PolyForm Noncommercial License 1.0.0. Ver ragtime/LICENSE para detalles.
- Documentación: docs/
- Problemas: GitHub Issues
- Repositorio: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Construido con Claude Agent SDK | Impulsado por Claude Code | Hecho con TypeScript
