🌱 Empieza aquí · Recordar conversaciones

Esta semilla le da a tu asistente memoria de largo plazo. Cuando le preguntes "¿en qué quedamos?", "¿qué decidimos de aquello?" o "¿qué he aprendido en este proyecto?", en vez de encogerse de hombros, busca dentro de tus conversaciones pasadas de Claude Code y te contesta con lo que de verdad discutieron. Trae búsqueda por palabras clave y varios "lentes" de análisis (recap, aprendizajes, decisiones, errores que se repiten).

Requisito importante: este skill (habilidad) solo lee un archivo de historial de tus conversaciones (una base de datos SQLite en ~/.claude-memory/conversations.db). Ese archivo lo genera una herramienta aparte de memoria de conversaciones que indexa tus sesiones. Si aún no la tienes, el skill te avisará que no encuentra el archivo. Instálala primero, o apunta el skill a cualquier base compatible con --db. Sin ese archivo, el skill no tiene qué leer.

Para instalarla

Abre esta carpeta con Claude Code y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar lo de recordar conversaciones", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (habilidad) con dos scripts de Python (solo librería estándar, sin instalar nada). El skill solo lee un DB de historial de conversaciones; no ejecuta ingesta ni escribe en el DB.

1. Copia el skill a la carpeta de skills

El skill vive en ~/.claude/skills/recall-conversations/. Copia ahí todo el contenido de kernel/ (el SKILL.md, la carpeta scripts/ y la carpeta references/).

macOS / Linux:

mkdir -p "$HOME/.claude/skills/recall-conversations"
cp -R kernel/. "$HOME/.claude/skills/recall-conversations/"

Windows (PowerShell):

New-Item -ItemType Directory -Force "$HOME\.claude\skills\recall-conversations" | Out-Null
Copy-Item -Recurse -Force "kernel\*" "$HOME\.claude\skills\recall-conversations\"

2. (Opcional) Configura grupos de proyectos

Por default el usuario filtra por --project (nombre exacto del proyecto), que siempre funciona. Si quiere agrupar varios proyectos bajo una etiqueta (por ejemplo trabajo, personal), copia el archivo de ejemplo y edítalo con sus categorías:

macOS / Linux:

cp "$HOME/.claude/skills/recall-conversations/scripts/groups.config.example.json" \
   "$HOME/.claude/skills/recall-conversations/scripts/groups.config.json"

Luego edita groups.config.json y reemplaza los patrones de ejemplo por rutas reales de los proyectos de esta persona. El formato completo está en el encabezado de scripts/lib/groups.py. Si no sabes sus categorías, deja el skill sin este archivo: funciona igual con --project.

3. (Si aplica) Apunta a un DB en otra ruta

Si el DB de historial no está en ~/.claude-memory/conversations.db, todos los comandos aceptan --db /ruta/al/archivo.db, o puedes exportar la variable de entorno RECALL_DB_PATH con esa ruta.

4. Verificación post-siembra (obligatoria)

a) Los archivos quedaron colocados:

ls -la "$HOME/.claude/skills/recall-conversations/SKILL.md" \
       "$HOME/.claude/skills/recall-conversations/scripts/search_conversations.py"; echo "exit=$?"

Salida esperada: las dos rutas listadas y exit=0. Si sale No such file or directory, la copia no se completó; repite el paso 1.

b) Los scripts corren (prueba de comportamiento):

python3 "$HOME/.claude/skills/recall-conversations/scripts/search_conversations.py" --help

Salida esperada: el texto de ayuda con las opciones (--query, --group, --lens, etc.) y exit=0. Esto confirma que Python y los scripts funcionan aunque el DB todavía no exista.

c) Prueba real contra el historial (si el DB ya existe):

python3 "$HOME/.claude/skills/recall-conversations/scripts/recent_chats.py" --n 2

Si el DB existe, verás tus 2 sesiones más recientes en markdown. Si en su lugar sale "Error: DB no encontrado...", el skill quedó bien instalado pero falta la herramienta que genera el historial (ver el requisito de arriba); avísale a la persona.

Cuando las partes (a) y (b) pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando le pidas a tu asistente "¿en qué quedamos con tal proyecto?" o "¿qué decisiones tomamos la semana pasada?", va a bucear en tus conversaciones pasadas y te va a traer un resumen con lo que de verdad discutieron, no un "no me acuerdo". Y cuando le pidas los "learnings" o los errores que se repiten, te ofrece guardarlos como reglas permanentes para que no se te olviden.

Lo único que necesitas es tener instalada la herramienta que va guardando el historial de tus sesiones. El resto lo hace el skill solo. 🌱