La tua mascotte di stato
Narsil è stata costruita parlando con Claude Code. Ogni guida di questo percorso spiega una sua funzionalità: cosa fa per chi la usa, gli hook e lo stato che ci sono dietro, le scelte di progetto e la richiesta da cui è partita.
Quando la richiesta originale è stata registrata, la guida la cita parola per parola. Quando non lo è, la guida lo dice e la ricostruisce dalla cronologia dei commit.
Le guide
- 1Gli stati a colpo d'occhioCome Narsil trasforma gli eventi della sessione in cinque stati, una frase sul passo in corso e un breve commento, disegnati nella fascia sopra il prompt.
- 2Disegno e animazioniCome viene disegnata Narsil: una posa per stato, chiaro e scuro in un solo SVG, loop animati ricavati da video IA e il limite di 131072 caratteri della fascia.
- 3Tutte le conversazioni in un solo postoCome Narsil raccoglie lo stato di ogni conversazione aperta in un hub locale, le ordina partendo dall'errore, le mostra quattro per pagina e dimentica quelle silenziose dopo un'ora.
- 4Task e subagentiCome Narsil ricostruisce l'elenco dei task di una conversazione da TodoWrite, TaskCreate, TaskUpdate e dal piano dell'app desktop, e mostra ogni subagente come un chip con tipo, modello e tempo.
- 5La finestra mobileCome Narsil mostra una finestra sempre in primo piano quando Claude è ridotto a icona o qualcosa ti aspetta, e perché il suo server ascolta solo su 127.0.0.1 con chiave di pagina e token della mod.
- 6Voce e avvisiCome Narsil sceglie una frase a caso per ogni momento, la pronuncia ad alta voce con le voci di Windows o di macOS e ti avvisa tramite la finestra mobile o una notifica di sistema.
- 7Contesto e limitiCome Narsil disegna la barra del contesto di ogni conversazione, stima quando si riempie al ritmo degli ultimi 15 minuti, suggerisce /compact una volta e mostra i limiti di 5 ore e settimanali.
- 8L'orologio della cacheCome Narsil conta alla rovescia la cache del prompt dall'inizio dell'ultima richiesta, 60 minuti con un abbonamento e 5 con una chiave API, e perché il turno dopo costa di più quando è fredda.
- 9Reazioni ai comandiCome Narsil legge i comandi di shell che Claude esegue: festeggia i test che passano, nota quelli che falliscono e avvisa dei comandi irreversibili senza mai bloccarli.
- 10Permessi che aspettanoCome Narsil insiste una volta quando un permesso, una domanda o un piano ti aspetta da cinque minuti, e perché controlla con un battito invece di impostare un timer.
- 11Consigli con HaikuCome Narsil chiede a Haiku un breve consiglio sul lavoro in corso: quale contesto invia, il prompt esatto, ogni quanto parla, la modalità profonda e la finestra dei consigli.
- 12Prossimi passiCome Narsil propone fino a tre prossimi passi 15 minuti dopo un turno, dai commit del progetto, dalle modifiche senza commit e dai task in sospeso, e mette nel prompt quello che scegli.
- 13Esperienza e crescitaCome Narsil guadagna esperienza da turni finiti, test superati e subagenti finiti, sale di livello, cresce in cinque stadi e festeggia, con gli XP conservati tra le sessioni.
- 14Modalità discretaCome /narsil discreto zittisce Narsil senza perdere gli avvisi che contano: cosa si ferma, cosa passa ancora e perché il confine è su "ha bisogno di te".
- 15Avvisi sul telefono e sull'orologioCome /narsil movil invia ciò che ha bisogno di te a un topic privato di ntfy.sh se scrivi da fuori: limite giornaliero, topic di stato silenzioso, chiave opzionale che sigilla il contenuto e Web Push.
- 16Riassunto della sessioneCome Narsil conta ciò che fa una conversazione (turni, file, comandi, fallimenti, subagenti) e continua a contare quando Claude Code si riavvia, per /narsil resumen e un riassunto dopo una pausa.
- 17I tuoi /comandiCome /narsil viene registrato come un solo comando slash con molti sottocomandi, come vengono smistate le sue parole, come il comando da solo fa anche da aiuto, e come testarlo.