Ir al contenido
Narsil Workshop

Tu propia mascota de estado

Narsil se construyó hablando con Claude Code. Cada guía de esta ruta explica una de sus funcionalidades: qué hace por quien la usa, los hooks y el estado que hay detrás, las decisiones de diseño y la petición con la que empezó.

Cuando la petición original quedó registrada, la guía la cita palabra por palabra. Cuando no, la guía lo dice y la reconstruye a partir del historial de commits.

Empieza la primera guía

Las guías

  1. 1Los estados de un vistazoCómo Narsil convierte los eventos de la sesión en cinco estados, una frase sobre el paso actual y un comentario breve, dibujados en la banda sobre el prompt.
  2. 2Dibujo y animacionesCómo se dibuja Narsil: una pose por estado, arte claro y oscuro en un solo SVG, bucles animados hechos con vídeos de IA y el límite de 131072 caracteres de la banda.
  3. 3Todas las conversaciones en un solo lugarCómo Narsil reúne el estado de cada conversación abierta en un hub local, las ordena con el error primero, las pagina de cuatro en cuatro y olvida las silenciosas al cabo de una hora.
  4. 4Tareas y subagentesCómo Narsil reconstruye las tareas de una conversación a partir de TodoWrite, TaskCreate, TaskUpdate y el plan de la app de escritorio, y muestra cada subagente con su tipo, modelo y tiempo.
  5. 5La ventana flotanteCómo Narsil muestra una ventana siempre visible cuando Claude está minimizado o algo te espera, y por qué su servidor local solo escucha en 127.0.0.1 tras una clave de página y un token del mod.
  6. 6Voz y avisosCómo Narsil elige una frase al azar para cada momento, la dice en voz alta con las voces propias de Windows o macOS y te avisa a través de la ventana flotante o de una notificación del sistema.
  7. 7Contexto y límitesCómo Narsil dibuja la barra de contexto de cada conversación, estima cuándo se llena al ritmo de los últimos 15 minutos, sugiere /compact una vez y muestra los límites de 5 horas y semanal.
  8. 8El reloj de la cachéCómo Narsil cuenta hacia atrás la caché del prompt desde la última petición, 60 minutos con suscripción y 5 con clave de API, y por qué el siguiente turno cuesta más cuando se enfría.
  9. 9Reacciones a los comandosCómo Narsil lee los comandos de shell que ejecuta Claude: celebra los tests que pasan, nota los que fallan y avisa de los comandos sin vuelta atrás sin bloquearlos nunca.
  10. 10Permisos que esperanCómo Narsil insiste una vez cuando un permiso, una pregunta o un plan llevan cinco minutos esperándote, y por qué lo comprueba con un latido en lugar de con un temporizador.
  11. 11Consejos con HaikuCómo Narsil pide a Haiku un consejo corto sobre el trabajo en curso: qué contexto envía, el prompt exacto, cada cuánto habla, el modo profundo y la ventana del consejo.
  12. 12Próximos pasosCómo Narsil propone hasta tres próximos pasos 15 minutos después de un turno, a partir de los commits, los cambios sin commit y las tareas pendientes, y pone en el prompt el que eliges.
  13. 13Experiencia y crecimientoCómo Narsil gana experiencia con los turnos terminados, los tests que pasan y los subagentes que acaban, sube de nivel, crece en cinco etapas y lo celebra, con XP que dura entre sesiones.
  14. 14El modo discretoCómo /narsil discreto silencia a Narsil sin perder los avisos que importan: qué se detiene, qué sigue llegando y por qué la línea se traza en "te necesita".
  15. 15Avisos en el móvil y el relojCómo /narsil movil envía lo que te necesita a un tema privado de ntfy.sh cuando escribes desde fuera: límite diario, tema de estado silencioso, una clave opcional que sella el contenido y Web Push.
  16. 16El resumen de la sesiónCómo Narsil cuenta lo que ha hecho una conversación (turnos, archivos, comandos, fallos, subagentes) y sigue contando cuando Claude Code se reinicia, para /narsil resumen y un resumen tras una pausa.
  17. 17Tus propios /comandosCómo /narsil se registra como un único comando de barra con muchos subcomandos, cómo se reparten sus palabras, cómo el comando sin argumentos sirve también de ayuda y cómo probarlo.