Masko for Claude Code

Qu’est-ce que Masko for Claude Code ?

Masko for Claude Code est un compagnon de bureau macOS gratuit et open source qui affiche une mascotte animée en overlay pendant les sessions Claude Code. Il suit l’activité des sessions en temps réel, s’affiche quand Claude a besoin d’une permission ou d’attention, et permet d’approuver ou refuser des actions sans quitter votre flux de codage.

L’app s’exécute en overlay léger et fournit un tableau de bord d’observabilité pour chaque session Claude — affichant l’état de la session, un flux d’activité et des invites de permission — tout en restant local via le système de hooks de Claude Code.

Fonctionnalités principales

• Mascotte overlay macOS pour Claude Code : Une mascotte flotte au-dessus des autres fenêtres et se met à jour selon l’état de la session courante (par ex., inactif, en cours, attention).
• Gestion des permissions en temps réel : Quand Claude demande à exécuter une commande, l’overlay propose un flux autoriser/refuser via le clavier, sans basculer sur la souris.
• Tableau de bord de notifications : Un tableau de bord montre des instantanés de session (par ex., en cours/en attente d’entrée/compression), un flux d’événements codé par couleur, et des résumés de session.
• Suivi des sous-agents : Surveille les agents enfants en temps réel pour voir ce qui se passe au-delà de la session principale.
• Contrôles de session clavier-first : Inclut des raccourcis pour basculer entre sessions, sauter vers l’onglet terminal exécutant Claude Code, et confirmer les actions de permission.
• Comportement local-first : L’app utilise le système de hooks de Claude Code pour recevoir les métadonnées d’événements (noms d’outils et état de session) mais ne lit pas votre code ; elle s’exécute localement sans envoyer de code vers un serveur.

Comment utiliser Masko for Claude Code

1. Télécharger et installer sur macOS : Installez l’app via le DMG macOS fourni ; elle s’installe dans la barre de menu sans encombrer le Dock.
2. Accorder l’accessibilité une fois : Au premier lancement, l’app installe automatiquement les hooks Claude Code et demandera la permission d’accessibilité pour l’overlay.
3. Démarrer Claude Code : Ouvrez un terminal et lancez Claude Code normalement pour que l’app observe les sessions.
4. Interagir depuis l’overlay : Quand une invite apparaît (par ex., Claude veut exécuter une commande ou pose une question), utilisez les raccourcis clavier pour approuver/refuser et focaliser le bon onglet terminal.
5. Choisir une mascotte : Utilisez l’une des six mascottes incluses par défaut, ou chargez des mascottes personnalisées depuis masko.ai dans l’app de bureau.

Cas d’usage

• Approuver les commandes Claude Code sans changer de contexte : Quand Claude demande une permission pour exécuter quelque chose (par ex., une commande de build), l’overlay présente des actions autoriser/refuser pour confirmer rapidement au clavier.
• Suivre ce que fait Claude sur plusieurs sessions : Avec un sélecteur de session et un saut vers le terminal focalisé sur la session, gérez plusieurs sessions Claude et passez à l’onglet terminal exact lié à chaque session.
• Examiner l’activité de session et les appels d’outils : Utilisez le tableau de bord de notifications pour inspecter les événements ordonnés (appels d’outils et complétions) et comprendre ce qui a changé dans une session au fil du temps.
• Gérer les moments « en attente d’entrée » : Quand une session indique qu’elle attend une entrée, le tableau de bord et les notifications aident à identifier cet état et à répondre promptly.
• Suivre l’activité des agents dépendant de sous-agents : Si votre workflow déclenche des agents enfants, le suivi des sous-agents affiche ces activités en temps réel pour suivre le chemin d’exécution complet.

FAQ

Masko for Claude Code est-il gratuit ?
Oui. Le compagnon de bureau est gratuit et open source, sous licence MIT.

Masko nécessite-t-il un serveur ou des clés API ?
Non. Les informations fournies indiquent qu’il n’y a pas de fichiers de config, pas de serveur, ni de clés API ; tout s’exécute localement.

Que collecte Masko, et lit-il mon code ?
Masko utilise le système de hooks de Claude Code et reçoit des métadonnées d’événements comme les noms d’outils et l’état de session. Il ne lit pas votre code.

Comment fonctionnent les mascottes ?
L’app inclut six mascottes par défaut. Vous pouvez aussi concevoir ou importer des mascottes personnalisées depuis masko.ai et les charger dans l’app de bureau.

Masko peut-il m’aider à sauter vers le bon terminal ?
Oui. L’overlay fournit un raccourci pour focaliser instantanément l’onglet terminal exécutant Claude Code, et supporte les terminaux et éditeurs mentionnés sur la page (par ex., iTerm2, Terminal.app, VS Code, Ghostty).

Alternatives

• Approches natives au terminal/éditeur (sans overlay) : Reposez-vous sur les invites de Claude Code dans votre terminal ou IDE, en répondant sur place. Cela diffère en exigeant un changement d’attention plutôt qu’un overlay et tableau de bord toujours actifs.
• Outils généraux de notifications/automation macOS : Utilisez le routage de notifications ou l’automatisation clavier pour mettre en évidence les invites et actions. C’est plus générique et peut ne pas offrir d’observabilité spécifique des sessions Claude Code ou d’état basé sur mascotte.
• Autres overlays de productivité développeur : Cherchez des outils offrant suivi de sessions et navigation rapide pour workflows développeurs. Ceux-ci se concentrent généralement sur la navigation de code ou l’historique de chat plutôt que sur les invites de permissions Claude Code et flux d’événements de session.
• Workflow CLI uniquement avec vérifications manuelles : Utilisez Claude Code en ligne de commande et passez manuellement les commandes en revue avant exécution. Cela offre une simplicité maximale mais manque de visibilité tableau de bord en temps réel et approbation un-clic/clavier depuis l’overlay.