Crea tus propios mods de Claude Code, paso a paso
Aprende cómo funcionan Narsil y Narsil Check por dentro, reconstruye cada funcionalidad desde cero y termina con un bot de Narsil que habla con Claude y muestra tus pull requests.


¿Qué es Narsil?
Narsil es un mod de Claude Code: una pequeña mascota que vive encima del prompt y te dice de un vistazo si Claude está trabajando, te necesita, ha terminado o se ha atascado. Narsil Check es su hermano, un panel lateral que revisa tu rama, la CI, las dependencias y las vulnerabilidades.
Aquí no solo los vas a instalar. Cada guía explica qué hooks escucha una funcionalidad, qué estado guarda y qué dibuja, y luego construye una versión mínima que funciona, con sus tests.
Lo que Narsil te dice de un vistazo
Cada estado tiene su propia pose y su color, así sabes qué está haciendo Claude sin leer la terminal.


Trabajando
Claude está leyendo, editando o ejecutando comandos.


Te necesita
Claude hizo una pregunta o espera un permiso.


Terminada
El turno terminó. Es momento de revisar qué cambió.


Error
Una herramienta falló o el turno se detuvo con un error.
Cómo se ve
La misma información te acompaña en todas partes: sobre el prompt, en una ventana flotante, en un panel lateral y en tu celular.








La ventana flotante usa datos de ejemplo, y la captura del celular es real, con los datos personales difuminados. El panel de Narsil Check está recreado a partir de su código, porque solo se dibuja dentro de Claude Code. El arte de Narsil viene de davshn/narsil-pet (GPL v3).
Tres rutas de aprendizaje
Las guías están en camino. Cada ruta empieza por los fundamentos de un mod.
Tu propia mascota de estado
Crea un mod como Narsil: estados encima del prompt, animaciones, todas las conversaciones en un sitio, una ventana flotante, voz, relojes de contexto y de caché, y avisos en el móvil.
Tu propio panel de revisión
Crea un mod como Narsil Check: un panel lateral con los pasos de la CI, la rama detrás de la remota, actualizaciones agrupadas por riesgo, vulnerabilidades de OSV.dev y herramientas para Claude.
Un bot de Narsil
Dale un cuerpo a Narsil: una pantalla táctil ESP32-P4 en la panza con tus tareas y tus pull requests, una cabeza holográfica ESP32-S3 con su cara, y voz con Xiaozhi y Claude en tu propio servidor.
Narsil en Claude, la extensión del navegador
Narsil también vive dentro de claude.ai en tu móvil: una extensión para Firefox y Vivaldi en Android muestra encima de la caja de texto el estado, el contexto, la caché y el último evento de la conversación abierta, y en el menú lateral el nivel de Narsil, tus límites de uso y los mensajes de ntfy.sh del día. Además viste Claude con los colores de Narsil.
Es experimental: está muy probada, pero se apoya en la estructura de la página de claude.ai y no en una API pública, así que una actualización de Claude puede romperla. Solo lee y nunca envía tus datos a ningún sitio. Su código no es público, pero las guías explican cómo se hace.
Gratis, y seguirá siéndolo
Sin anuncios, sin registro y sin precio. Si una guía te ayuda, puedes invitarme un café para escribir la siguiente.
Invítame un café