Ir al contenido
Narsil Workshop

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.

Narsil, un pequeño dragón marino, saludandoNarsil, un pequeño dragón marino, saludando

¿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.

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 de Narsil: una conversación trabajando con sus tareas, las barras de uso y otras dos conversaciones abiertasLa ventana flotante de Narsil: una conversación trabajando con sus tareas, las barras de uso y otras dos conversaciones abiertas
La ventana flotanteNarsil, tus límites de uso y cada conversación abierta con su contexto, tareas, caché y próximos pasos, en una ventana pequeña que queda siempre encima.
El panel de Narsil Check: entorno y CI, tres actualizaciones de librerías, una vulnerabilidad y dos tareas pendientesEl panel de Narsil Check: entorno y CI, tres actualizaciones de librerías, una vulnerabilidad y dos tareas pendientes
El panel de Narsil CheckUn panel lateral con el entorno de la sesión, los pasos del CI, las actualizaciones de librerías agrupadas por riesgo, las vulnerabilidades y las tareas pendientes.
El menú lateral de claude.ai en un celular Android con el bloque de Narsil: el nivel, los límites de 5 horas y de la semana, y los mensajes de ntfy del día. Los datos personales están difuminados.El menú lateral de claude.ai en un celular Android con el bloque de Narsil: el nivel, los límites de 5 horas y de la semana, y los mensajes de ntfy del día. Los datos personales están difuminados.
Una conversación de claude.ai en un celular Android: sobre la caja de texto, la franja de Narsil muestra el estado TRABAJANDO, el contexto al 80 %, la caché a 60 min y el último evento, Usando Bash. La conversación está difuminada.Una conversación de claude.ai en un celular Android: sobre la caja de texto, la franja de Narsil muestra el estado TRABAJANDO, el contexto al 80 %, la caché a 60 min y el último evento, Usando Bash. La conversación está difuminada.
Narsil en Claude, en tu celularUna extensión experimental que lleva a Narsil dentro de claude.ai en Android: en el menú lateral, su nivel, tus límites de uso y los mensajes de ntfy del día; sobre la caja de texto, el estado de la conversación abierta. Su código no es público, pero las guías explican cómo se hace.

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.

Experimental

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é