Pular para o conteúdo
Narsil Workshop

Seu próprio mascote de status

O Narsil foi construído conversando com o Claude Code. Cada guia desta trilha explica uma de suas funcionalidades: o que ela faz por quem a usa, os hooks e o estado por trás dela, as decisões de design e o pedido que deu início a ela.

Quando o pedido original ficou registrado, o guia o cita palavra por palavra. Quando não, o guia avisa e o reconstrói a partir do histórico de commits.

Comece o primeiro guia

Os guias

  1. 1Os estados num relanceComo a Narsil transforma os eventos da sessão em cinco estados, uma frase sobre o passo atual e um comentário curto, desenhados na faixa acima do prompt.
  2. 2Desenho e animaçõesComo a Narsil é desenhada: uma pose por estado, arte clara e escura num só SVG, loops animados feitos a partir de vídeos de IA e o limite de 131072 caracteres da faixa.
  3. 3Todas as conversas num só lugarComo a Narsil reúne o estado de cada conversa aberta num hub local, ordena com o erro primeiro, pagina de quatro em quatro e esquece as silenciosas depois de uma hora.
  4. 4Tarefas e subagentesComo a Narsil reconstrói a lista de tarefas de uma conversa a partir de TodoWrite, TaskCreate, TaskUpdate e do plano do app de desktop, e mostra cada subagente com tipo, modelo e tempo.
  5. 5A janela flutuanteComo a Narsil mostra uma janela sempre visível quando o Claude está minimizado ou algo espera por você, e por que o servidor local escuta só em 127.0.0.1 com chave de página e token.
  6. 6Voz e alertasComo a Narsil escolhe uma frase aleatória para cada momento, a diz em voz alta com as vozes do próprio Windows ou macOS e avisa você pela janela flutuante ou por uma notificação do sistema.
  7. 7Contexto e limitesComo a Narsil desenha a barra de contexto de cada conversa, estima quando ela enche no ritmo dos últimos 15 minutos, sugere /compact uma vez e mostra os limites de 5 horas e semanal.
  8. 8O relógio do cacheComo a Narsil conta o tempo do cache do prompt desde o início da última requisição, 60 minutos numa assinatura e 5 com chave de API, e por que o próximo turno custa mais quando esfria.
  9. 9Reações aos comandosComo a Narsil lê os comandos de shell que o Claude executa: comemora testes que passam, percebe os que falham e avisa sobre comandos sem volta atrás, sem nunca bloqueá-los.
  10. 10Permissões que esperamComo a Narsil insiste uma vez quando uma permissão, uma pergunta ou um plano espera por você há cinco minutos, e por que ela confere num batimento em vez de criar um temporizador.
  11. 11Dicas com o HaikuComo a Narsil pede ao Haiku uma dica curta sobre o trabalho em andamento: o contexto que envia, o prompt exato, com que frequência fala, o modo profundo e a janela da dica.
  12. 12Próximos passosComo a Narsil propõe até três próximos passos 15 minutos depois de um turno, a partir dos commits, das mudanças sem commit e das tarefas pendentes, e põe no prompt o que você escolher.
  13. 13Experiência e crescimentoComo a Narsil ganha experiência com turnos terminados, testes que passam e subagentes que terminam, sobe de nível, cresce por cinco estágios e comemora, com a XP guardada entre sessões.
  14. 14Modo discretoComo /narsil discreto silencia a Narsil sem perder os alertas que importam: o que para, o que ainda passa, e por que a linha é traçada em "ela precisa de você".
  15. 15Alertas no celular e no relógioComo /narsil movil envia o que precisa de você a um tópico privado do ntfy.sh quando escreve de longe, com limite diário, tópico de estado silencioso, chave opcional que sela o conteúdo e Web Push.
  16. 16Resumo da sessãoComo a Narsil conta o que uma conversa fez (turnos, arquivos, comandos, falhas, subagentes) e continua contando quando o Claude Code reinicia, para /narsil resumen e um resumo depois de uma pausa.
  17. 17Seus próprios /comandosComo /narsil é registrado como um único comando de barra com muitos subcomandos, como as suas palavras são despachadas, como o comando sozinho serve de ajuda e como testá-lo.