Hábitos
Un hábito es una práctica que quieres sostener en el tiempo. A diferencia de una tarea (que se completa y desaparece) o de un evento (que tiene una fecha específica), un hábito se registra día a día y lo que importa es la constancia, la racha y la tendencia.
Le dices al agente "quiero crear un hábito de leer 30 minutos cada día" y queda creado con la frecuencia y duración que definas.
Crear un hábito
El agente Administración y productividad tiene la tool create_habit. Define:
- Título — qué quieres hacer ("Meditar", "Correr", "Aprender inglés")
- Emoji — ícono visual para el dashboard
- Tipo de actividad — clasificación (ejercicio, meditación, lectura, idioma, etc.) — afecta el color y las estadísticas agregadas
- Frecuencia — tres modos:
- Diario: todos los días
- Semanal: una vez por semana
- Personalizado: tú eliges qué días concretos (lunes, miércoles, viernes, por ejemplo, usando
recurrence_days=[1, 3, 5])
- Duración esperada (opcional) — minutos por sesión. Útil si quieres registrar no solo si hiciste la actividad, sino cuánto tiempo le dedicaste
También puedes crear y configurar hábitos desde la pestaña Hábitos en la UI.
Registrar completado
El agente tiene log_habit para marcar un hábito como cumplido en un día específico. Desde la UI tienes dos caminos:
- Rápido — tocas el checkbox del card en el dashboard y queda registrado para hoy
- Detallado — abres el diálogo de registro y agregas duración (con selector de horas/minutos) y notas opcionales. Útil si quieres saber no solo si meditaste, sino cuánto tiempo
También puedes registrar días pasados tocando la celda correspondiente en el grid de contribución.
El grid de contribución
La pantalla de detalle de un hábito muestra un grid estilo GitHub donde cada celda es un día:
- Verde lleno — completaste ese día
- Verde tenue — completaste parcialmente (si registraste menos duración que la esperada)
- Vacío — no completaste
Puedes cambiar la escala entre semana, mes, trimestre y año para ver la tendencia a diferentes resoluciones.
Rachas y estadísticas
La tool read_habit_stats (y la UI de detalle) muestran:
- Racha actual — cuántos días consecutivos llevas cumpliendo
- Mejor racha — récord histórico
- Tasa de cumplimiento — porcentaje de días cumplidos en los últimos 90 días
- Total de completados — todas las veces que has completado el hábito
read_habit_calendar devuelve una representación textual del grid de 12 semanas — útil cuando le preguntas al chat "¿cómo va mi hábito de meditación?".
Pausa y archivado
Si necesitas pausar un hábito temporalmente — vacaciones, enfermedad, lo que sea — edit_habit lo pone en estado paused. No se borran las estadísticas ni se rompe la racha acumulada. Cuando lo reactivas (status=active), retoma desde donde estaba sin romper el historial.
El estado archived lo saca del dashboard sin borrarlo, por si más adelante quieres revisar el histórico.
delete_habit es soft-delete: marca un deleted_at pero conserva la fila por si la necesitas recuperar.
Resumen de tools
| Tool | Para qué |
|---|---|
read_habits | Lista hábitos activos/pausados/archivados con su racha actual. |
create_habit | Crea un hábito nuevo con frecuencia + tipo + duración esperada. |
edit_habit | Renombra, cambia frecuencia o estado (preserva streaks al pausar). |
delete_habit | Soft-delete. |
log_habit | Marca cumplimiento de un día (requiere habit_id válido). |
read_habit_stats | Streak actual + mejor + tasa de cumplimiento. |
read_habit_calendar | Grid de contribución 12 semanas en texto. |