Masko for Claude Code

Cos'è Masko for Claude Code?

Masko for Claude Code è un compagno desktop gratuito e open source per macOS che visualizza una mascotte animata sovrapposta alle sessioni di Claude Code. Monitora l'attività delle sessioni in tempo reale, si attiva quando Claude richiede permessi o attenzione e ti permette di approvare o negare azioni senza interrompere il tuo flusso di lavoro di coding.

L'app funziona come una finestra overlay leggera e fornisce una dashboard di osservabilità per ogni sessione Claude—mostrando stato della sessione, feed di attività e prompt di permessi—mantenendo tutto locale tramite il sistema di hook di Claude Code.

Caratteristiche Principali

• Mascotte overlay macOS per Claude Code: Una mascotte fluttua sopra le altre finestre e si aggiorna in base allo stato della sessione corrente (es. idle, working, attention).
• Gestione permessi in tempo reale: Quando Claude chiede di eseguire un comando, l'overlay offre un flusso allow/deny da tastiera invece di passare al mouse.
• Dashboard notifiche: Una dashboard mostra snapshot delle sessioni (es. running/awaiting input/compacting), un feed eventi con codici colore e riassunti delle sessioni.
• Monitoraggio subagenti: Monitora gli agenti secondari in tempo reale per vedere cosa succede oltre la sessione principale.
• Controlli sessione da tastiera: Include scorciatoie per passare tra sessioni, saltare alla tab terminale con Claude Code e confermare azioni di permesso.
• Comportamento local-first: L'app usa il sistema di hook di Claude Code per ricevere metadati eventi (nomi tool e stato sessione) ma non legge il tuo codice; gira localmente senza inviare codice a un server.

Come Usare Masko for Claude Code

1. Scarica e installa su macOS: Installa l'app tramite il DMG macOS fornito; l'app risiede nella barra menu senza ingombrare il Dock.
2. Concedi accessibilità una volta: Al primo avvio, l'app installa automaticamente gli hook di Claude Code e richiede il permesso di accessibilità per l'overlay.
3. Avvia Claude Code: Apri un terminale e avvia Claude Code normalmente così l'app può osservare le sessioni.
4. Interagisci dall'overlay: Quando richiesto (es. Claude vuole eseguire un comando o fare una domanda), usa le scorciatoie da tastiera per approvare/negare e focalizzare la tab terminale corretta.
5. Scegli una mascotte: Usa una delle sei mascotte incluse di default, o carica mascotte personalizzate da masko.ai nell'app desktop.

Casi d'Uso

• Approva comandi Claude Code senza cambio contesto: Quando Claude richiede permesso per eseguire qualcosa (es. comando build), l'overlay presenta azioni allow/deny per confermare rapidamente da tastiera.
• Segui cosa fa Claude su più sessioni: Con un selettore sessioni e salto a terminale focalizzato sulla sessione, gestisci più sessioni Claude e vai alla tab terminale esatta per ciascuna.
• Rivedi attività sessione e chiamate tool: Usa la dashboard notifiche per ispezionare eventi ordinati (chiamate tool e completamenti) e capire cosa è cambiato nella sessione nel tempo.
• Gestisci momenti “in attesa input”: Quando una sessione indica attesa input, dashboard e notifiche ti aiutano a identificare quello stato e rispondere prontamente.
• Traccia attività agenti dipendenti da subagenti: Se il tuo workflow attiva agenti secondari, il monitoraggio subagenti mostra quelle attività in tempo reale per seguire il percorso di esecuzione completo.

FAQ

Masko for Claude Code è gratuito?
Sì. Il compagno desktop è gratuito e open source, con licenza MIT.

Masko richiede server o chiavi API?
No. Non ci sono file di config, server o chiavi API; tutto gira localmente.

Cosa raccoglie Masko e legge il mio codice?
Masko usa il sistema di hook di Claude Code e riceve metadati eventi come nomi tool e stato sessione. Non legge il tuo codice.

Come funzionano le mascotte?
L'app include sei mascotte di default. Puoi anche progettare o importare mascotte personalizzate da masko.ai e caricarle nell'app desktop.

Masko può aiutarmi a saltare al terminale giusto?
Sì. L'overlay offre una scorciatoia per focalizzare istantaneamente la tab terminale con Claude Code, e supporta terminali ed editor menzionati (es. iTerm2, Terminal.app, VS Code, Ghostty).

Alternative

• Approcci nativi terminale/editor (senza overlay): Affidati ai prompt di Claude Code all’interno del tuo terminale o IDE, rispondendo sul posto. Differisce perché richiede di spostare l’attenzione invece di usare un overlay sempre attivo e dashboard.
• Strumenti generali di notifiche/automazione macOS: Usa il routing delle notifiche o l’automazione da tastiera per evidenziare prompt e azioni. È più generico e potrebbe non offrire osservabilità specifica delle sessioni di Claude Code o stato basato su mascotte.
• Altri overlay per produttività developer: Cerca tool che forniscano tracciamento sessioni e navigazione rapida per workflow developer. Tipicamente si concentrano su navigazione codice o cronologia chat anziché prompt permessi di Claude Code e feed eventi sessione.
• Workflow solo CLI con controlli permessi manuali: Esegui Claude Code dalla command line e rivedi manualmente i comandi prima di eseguirli. Offre massima semplicità ma manca di visibilità dashboard in tempo reale e approvazione con un clic/tastiera dall’overlay.