Memoria infinita para Claude Code · dos herramientas open source

Antes de instalar cualquier sistema de memoria persistente, quiero saber qué tengo activo hoy en este equipo. Hazme un diagnóstico rápido en cinco bullets.

1. Revisa si Claude-Mem está instalado: busca la carpeta ~/.claude-mem/ y el archivo ~/.claude-mem/settings.json. Si existe, dime qué versión instalada hay y si el worker (localhost:37777) responde.

2. Revisa si MemPalace está instalado: corre uv tool list y busca mempalace en la salida. Si está, dime qué versión y si hay un palace inicializado en el directorio actual (mira si hay carpeta .mempalace o equivalente).

3. Revisa los hooks actuales: lee ~/.claude/settings.json y dime qué hooks tiene registrados (nombre + comando). Si ves hooks de claude-mem o mempalace ahí, márcalos.

4. Revisa la sesión actual de Claude Code: ¿estoy en un proyecto con .claude/ propio? ¿hay alguna skill o MCP configurado relacionado con memoria?

5. Resumen en tres bullets:
   - Qué memoria tengo activa hoy (ninguna / Claude-Mem / MemPalace / las dos).
   - Si tengo las dos a la vez, márcalo como warning porque sus hooks pueden chocar.
   - Recomendación: ¿necesito limpiar algo antes de instalar lo nuevo?

No instales ni borres nada todavía. Solo el reporte. Cuando lo apruebe, te paso el siguiente prompt.

Quiero instalar Claude-Mem (https://github.com/thedotmack/claude-mem) en este equipo. Es un plugin de Claude Code que captura observaciones automáticamente vía cinco hooks (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd) y las inyecta de vuelta al arrancar la siguiente sesión. Apache 2.0, todo local.

Pasos en orden. Confirma cada uno antes de avanzar al siguiente.

1. Verifica prerequisitos
   - node --version → tiene que ser 18 o superior. Si es menor, detén el flujo y dime cómo actualizar Node (recomienda nvm si estoy en Mac/Linux, fnm si prefiero algo más nuevo).
   - Confirma que Claude Code está instalado y funcionando.

2. Corre el instalador oficial
   - npx claude-mem install
   - Si pregunta por IDE, déjalo en defaults (Claude Code).
   - El instalador puede auto-instalar Bun y uv para vector search — déjalo correr.

3. Verifica que arrancó
   - Lee ~/.claude-mem/settings.json y dime qué configuración default quedó (modelo, puerto, data dir, log level).
   - Verifica que el worker local responde: curl -s http://localhost:37777 o abre el dashboard en el navegador.

4. Verifica los hooks
   - Lee ~/.claude/settings.json (no ~/.claude-mem/) y dime cuáles de los cinco hooks de claude-mem quedaron registrados.

5. Cierre
   - Pídeme reiniciar Claude Code para que los hooks queden activos.
   - Dame el link del dashboard local (http://localhost:37777) para que pueda ver el stream de memoria en tiempo real.

Si algo falla:
- "command not found: npx" → necesito instalar Node con nvm primero.
- "npm install -g claude-mem" no es el comando correcto: registra solo el SDK. Tiene que ser npx claude-mem install para que registre los hooks y el worker.
- Worker no responde en localhost:37777 → revisa que ningún otro servicio esté usando ese puerto. Si está ocupado, edita CLAUDE_MEM_WORKER_PORT en ~/.claude-mem/settings.json.

Al final dime: versión instalada, qué hooks quedaron registrados, ruta del settings y ruta del data dir.

Quiero instalar MemPalace (https://github.com/mempalace/mempalace) en este proyecto. Es un sistema de memoria local-first MIT con 96.6% R@5 en LongMemEval. Todo vive en mi compu, cero pagos, cero nube.

Pasos en orden. Confirma cada uno.

1. Verifica Python y uv
   - python3 --version → tiene que ser 3.9 o superior. Si es menor, dime cómo instalar uno nuevo (pyenv si estoy en Mac/Linux).
   - which uv → si no tengo uv, instálalo con el script oficial:
       curl -LsSf https://astral.sh/uv/install.sh | sh
     (Para Windows o si quiero el método manual, consulta https://docs.astral.sh/uv/getting-started/installation/.)
   - Después del install de uv, reabre la terminal o source el shell rc para que el binario quede en el PATH.

2. Instala MemPalace como tool global de uv
   - uv tool install mempalace
   - Verifica con uv tool list que mempalace aparece.

3. Inicializa el palace para este proyecto
   - Desde la raíz del proyecto donde estamos trabajando ahora:
       mempalace init .
   - Si quiero scope por proyecto distinto, uso el flag --wing:
       mempalace init . --wing nombre-del-proyecto

4. Activa el hook de auto-save
   - Importante: sin este hook las sesiones de Claude Code expiran a los 30 días y se pierden los transcripts antes de poder indexarlos.
   - Edita ~/.claude/settings.json y agrega el hook de mempalace sweep para que corra automáticamente cuando se cierra una sesión. La documentación oficial dice exactamente qué pegar; léela en https://github.com/mempalace/mempalace y pega el snippet correcto.

5. Smoke test
   - Corre mempalace mine . para indexar lo que ya hay en el proyecto.
   - Corre mempalace search "qué hicimos ayer" para probar que la búsqueda responde.
   - Si las dos funcionan, MemPalace está listo.

Si algo falla:
- "uv: command not found" después del install → reabre la terminal o agrega ~/.local/bin al PATH manualmente.
- Python <3.9 → instala uno nuevo con pyenv y vuelve a correr todo.
- mempalace init falla con permisos → corre desde una carpeta donde tengo permisos de escritura (no /).

Al final dime: versión de mempalace instalada, ruta donde quedó el palace, comandos disponibles y si el hook de auto-save quedó registrado en ~/.claude/settings.json.

Empecé con Claude-Mem porque la instalación de un comando me sirvió para arrancar rápido. Ahora quiero pasarme a MemPalace para tener control total y todo en formato local más auditable. Necesito migrar sin perder lo que Claude-Mem ya guardó.

Pasos.

1. Inventario de lo que tengo en Claude-Mem
   - Lee ~/.claude-mem/ y dime: tamaño total, cuántas observaciones, rango de fechas (la más vieja vs la más nueva).
   - Abre el dashboard local (localhost:37777) para confirmar visualmente.

2. Exporta el contenido en formato plano
   - Claude-Mem usa SQLite + Chroma. Sácame los textos crudos de las observaciones en formato Markdown o JSONL, una entrada por archivo o una entrada por línea.
   - Guarda el dump en ~/claude-mem-export/.

3. Verifica que el export es legible
   - Abre 3 archivos al azar del dump y confírmame que el contenido tiene sentido (no son blobs binarios).

4. Importa al palace de MemPalace
   - Si MemPalace todavía no está instalado, corre primero el prompt instalar-mempalace.
   - Una vez instalado, corre:
       mempalace sweep ~/claude-mem-export/
     para que MemPalace convierta esos archivos en drawers del palace.
   - Verifica con mempalace search "<algo que sé que estaba en Claude-Mem>" que el contenido quedó indexado.

5. Desactiva los hooks de Claude-Mem
   - Importante: si dejas los dos sistemas corriendo, los hooks chocan y la sesión se siente lenta o se duplican capturas.
   - Edita ~/.claude/settings.json y quita los hooks de claude-mem (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd).
   - Deja activos solo los hooks de mempalace.

6. Cierre
   - Reinicia Claude Code.
   - Confirma que solo mempalace está corriendo (mempalace status si existe el subcomando, o revisa que el worker de Claude-Mem ya no esté en localhost:37777).
   - Si todo se ve bien y la búsqueda funciona, puedo borrar ~/.claude-mem/ para liberar disco. Pídeme confirmación antes de hacerlo.

Si algo falla:
- Export vacío → revisa el path de la base de datos de Claude-Mem en ~/.claude-mem/settings.json.
- mempalace sweep no acepta el formato → conviértelo a Markdown puro y vuelve a intentar.
- Sesión lenta después del cierre → confirma que los hooks de claude-mem realmente quedaron fuera de ~/.claude/settings.json.

Quiero desinstalar [CLAUDE-MEM | MEMPALACE] de este equipo. Quítalo de raíz y déjame ~/.claude/settings.json exactamente como estaba antes.

Pasos.

1. Antes de borrar nada, hazme un backup
   - Copia ~/.claude/settings.json a ~/.claude/settings.json.backup-YYYY-MM-DD.
   - Confírmame que el backup quedó creado.

2. Si voy a desinstalar Claude-Mem
   - Para Claude-Mem (Apache 2.0, npx claude-mem install):
       a. Detén el worker local si está corriendo: pkill -f claude-mem o el comando equivalente que documenta el repo.
       b. Lee ~/.claude/settings.json y quita los hooks de claude-mem (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd que apuntan a binarios de claude-mem).
       c. Borra la carpeta de datos: rm -rf ~/.claude-mem/.
       d. Si por error instalé el SDK con npm install -g claude-mem, desinstálalo con npm uninstall -g claude-mem.

3. Si voy a desinstalar MemPalace
   - Para MemPalace (MIT, uv tool install mempalace):
       a. Detén cualquier proceso de mempalace en background.
       b. Quita los hooks de mempalace de ~/.claude/settings.json (sobre todo el de auto-save / sweep).
       c. Desinstala el tool de uv: uv tool uninstall mempalace.
       d. Borra la carpeta del palace en cada proyecto donde haya un .mempalace/ o equivalente. Lístame primero las rutas antes de borrar.

4. Verificación final
   - Confírmame archivo por archivo qué tocaste: ruta + qué quitaste + qué quedó.
   - Verifica que el otro sistema (el que quiero conservar, si lo tengo) sigue intacto.
   - Reinicia Claude Code para que los hooks recargados queden limpios.

5. Rollback
   - Si algo se rompió, restaura el backup:
       mv ~/.claude/settings.json.backup-YYYY-MM-DD ~/.claude/settings.json
     y dime qué pasó.

Importante: no toques ~/.claude/projects/ — ahí viven los transcripts crudos de Claude Code y no son parte de ninguno de los dos sistemas.