🌱 Empieza aquí · Tablero de arranque en vivo

¿Te ha pasado que abres una sesión con tu asistente y arranca "en frío", sin saber qué día es, cómo anda tu memoria ni qué tenías pendiente? Esta semilla le pone a tu asistente un tablero de arranque que se calcula solo cada vez que empiezas: la fecha de hoy, si tus archivos clave están sanos, si tu memoria ya creció de más, cuántos pendientes tienes en la cola, si llegaron archivos de otra computadora y un "tip del día" para redescubrir lo que ya tienes. Lo mejor: nada está escrito a mano, así que nunca se queda viejo.

Para instalarla

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

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo técnico 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 el tablero de arranque", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Instala este hook (gancho de automatización) del evento SessionStart (inicio de sesión). Es un script de Python 3 que imprime un JSON {"systemMessage": "..."} con el tablero. Sigue estos pasos y no inventes rutas: usa $HOME siempre.

0. Confirma que hay Python 3

python3 --version

Si no responde con una versión, avísale a la persona: este hook necesita python3 en el sistema (viene por defecto en macOS y Linux; en Windows se instala aparte o vía WSL).

1. Copia el script del kernel (el corazón de la semilla)

mkdir -p "$HOME/.claude/hooks"
cp kernel/boot-dashboard.py "$HOME/.claude/hooks/boot-dashboard.py"
chmod +x "$HOME/.claude/hooks/boot-dashboard.py"

Windows (Git Bash / WSL): misma ruta ~/.claude/hooks/. Asegúrate de que python3 esté disponible en ese entorno.

2. Registra el hook en `settings.json`

Abre $HOME/.claude/settings.json (créalo si no existe) y agrega esta entrada dentro de hooks.SessionStart. Si ya hay hooks de SessionStart, suma este objeto al arreglo hooks existente en lugar de reemplazarlo:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "python3 $HOME/.claude/hooks/boot-dashboard.py",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

3. (Opcional) Ajusta límites, rutas o enciende la cuenta regresiva

Sin configurar nada, el script autodetecta todo usando solo $HOME. Si la persona quiere personalizar, hay dos caminos: cambiar el valor por defecto en el bloque CONFIG de boot-dashboard.py (lo más simple), o exportar variables de entorno antes de que corra el hook. Estas son las que entiende:

BASE_DIR — carpeta base del asistente (por defecto $HOME/.claude).
INSTRUCTIONS_FILE — archivo maestro de instrucciones (vacío = autodetecta CLAUDE.md o AGENTS.md).
INSTRUCTIONS_MAX_LINES — tope de líneas para el indicador de instrucciones (por defecto 180).
MEMORY_FILE — archivo de memoria persistente (vacío = autodetecta).
MEMORY_MAX_KB / MEMORY_MAX_LINES — topes del indicador de memoria (por defecto 25 KB / 180 líneas).
PENDING_DIR — carpeta de pendientes; se cuentan los *.md (por defecto $BASE_DIR/next-tickets).
SYNC_FILE — archivo con el delta de sync entre máquinas (por defecto $BASE_DIR/.last-sync-info).
SKILLS_DIR — carpeta de skills para el "tip del día" (por defecto $BASE_DIR/skills).
WHATS_NEW_FILE — archivo opcional de novedades (1ª línea = fecha, resto una por línea).
COUNTDOWN_DATE — fecha AAAA-MM-DD para una cuenta regresiva opcional (vacío = apagada).
COUNTDOWN_LABEL — texto del evento de la cuenta regresiva (ej. "el lanzamiento").

4. Verificación post-siembra (obligatoria)

Comprueba que el script corre y produce un JSON válido con el tablero:

python3 "$HOME/.claude/hooks/boot-dashboard.py" | python3 -c "import json,sys; d=json.load(sys.stdin); print('OK'); print(d['systemMessage'])"; echo "EXIT=$?"

Salida esperada: OK, seguido de dos o más líneas de tablero (la fecha de hoy en español, la salud de archivos, el indicador de memoria/instrucciones y los pendientes), y EXIT=0. Si en vez de eso ves un error de Python o el JSON no parsea, revisa que el archivo se copió completo y que python3 está disponible.

Confirma también que el hook quedó registrado en settings.json:

grep -q 'boot-dashboard' "$HOME/.claude/settings.json" && echo 'REGISTRADO'

Salida esperada: REGISTRADO.

Por último, la prueba de verdad: pídele a la persona que abra una sesión nueva. En el arranque debe aparecer el tablero como primer mensaje del sistema. Si aparece, el hook está vivo. Explícale en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cada vez que abras una sesión de trabajo vas a ver un pequeño tablero arriba: la fecha de hoy, un ✅ o ⚠️ según cómo estén tus archivos clave y tu memoria, cuántos pendientes traes y un tip del día. No tienes que hacer nada especial: solo échale un ojo al arrancar. Si algún indicador sale en ⚠️, es tu señal para pedirle a tu asistente que lo ordene (por ejemplo, "resume la memoria"). Todo lo demás se calcula solo. Eso es todo. 🌱