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.


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.


Working
Claude is reading, editing, or running commands.


Needs you
Claude asked a question or is waiting for a permission.


Done
The turn ended. Time to review what changed.


Error
A tool failed or the turn stopped with an error.
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 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.
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