Skip to content
Narsil Workshop

Build your own Claude Code mods, step by step

Learn how Narsil and Narsil Check work inside, rebuild each feature from scratch, and finish with a Narsil desk bot that talks with Claude and shows your pull requests.

Narsil, a small sea dragon, waving helloNarsil, a small sea dragon, waving hello

What is Narsil?

Narsil is a Claude Code mod: a small pet that lives above the prompt and tells you, at a glance, whether Claude is working, waiting for you, done, or stuck. Narsil Check is its sibling, a side panel that reviews your branch, CI, dependencies, and vulnerabilities.

Here you will not just install them. Each guide explains which hooks a feature listens to, what state it keeps, and what it draws, and then builds a minimal version that works, with its tests.

What Narsil tells you at a glance

Each state has its own pose and color, so you know what Claude is doing without reading the terminal.

How it looks

The same information follows you everywhere: above the prompt, in a floating window, in a side panel, and on your phone.

The Narsil floating window: a conversation at work with its tasks, the usage bars, and two more open conversationsThe Narsil floating window: a conversation at work with its tasks, the usage bars, and two more open conversations
The floating windowNarsil, your usage limits, and every open conversation with its context, tasks, cache, and next steps, in a small window that stays on top.
The Narsil Check panel: environment and CI, three dependency updates, one vulnerability, and two pending tasksThe Narsil Check panel: environment and CI, three dependency updates, one vulnerability, and two pending tasks
The Narsil Check panelA side panel with the session environment, CI steps, dependency updates grouped by risk, vulnerabilities, and pending tasks.
The claude.ai side menu on an Android phone with the Narsil block: the level, the 5-hour and weekly limits, and the ntfy messages of the day. Personal details are blurred.The claude.ai side menu on an Android phone with the Narsil block: the level, the 5-hour and weekly limits, and the ntfy messages of the day. Personal details are blurred.
A conversation on claude.ai on an Android phone: above the message box, the Narsil band shows the state TRABAJANDO (working), the context at 80 %, the cache at 60 min, and the last event, Usando Bash (using Bash). The conversation is blurred.A conversation on claude.ai on an Android phone: above the message box, the Narsil band shows the state TRABAJANDO (working), the context at 80 %, the cache at 60 min, and the last event, Usando Bash (using Bash). The conversation is blurred.
Narsil in Claude, on your phoneAn experimental extension that brings Narsil into claude.ai on Android: in the side menu, its level, your usage limits, and the ntfy messages of the day; above the message box, the state of the open conversation. Its code is not public, but the guides explain how it is built.

The floating window uses example data, and the phone capture is real, with personal details blurred. The Narsil Check panel is recreated from its source code, because it only renders inside Claude Code. Narsil art comes from davshn/narsil-pet (GPL v3).

Three learning paths

The guides are on their way. Each path starts with the basics of a mod.

Your own status pet

Build a mod like Narsil: states above the prompt, animations, every conversation in one place, a floating window, voice, context and cache clocks, and alerts on your phone.

Your own review panel

Build a mod like Narsil Check: a side panel with CI steps, a branch behind its remote, dependency updates grouped by risk, OSV.dev vulnerabilities, and tools for Claude.

A Narsil desk bot

Give Narsil a body: an ESP32-P4 touch screen in the belly with your tasks and pull requests, a holographic ESP32-S3 head with her face, and a voice through Xiaozhi and Claude on your own server.

Experimental

Narsil in Claude, the browser extension

Narsil also lives inside claude.ai on your phone: an extension for Firefox and Vivaldi on Android shows above the message box the state, context, cache, and last event of the open conversation, and in the side menu the Narsil level, your usage limits, and the ntfy.sh messages of the day. It also dresses Claude in the Narsil colors.

It is experimental: it is well tested, but it relies on the structure of the claude.ai page, not on a public API, so a Claude update can break it. It only reads, and it never sends your data anywhere. Its code is not public, but the guides explain how it is built.

Free, and it will stay free

No ads, no sign-up, and no price. If a guide helps you, you can buy me a coffee to help write the next one.

Buy me a coffee