Vai al contenuto
Narsil Workshop

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.

Inizia la prima guida

Le guide

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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.
  10. 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.
  11. 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.
  12. 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.
  13. 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.
  14. 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".
  15. 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.
  16. 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.
  17. 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.