Masko for Claude Code

O que é Masko for Claude Code?

Masko for Claude Code é um companheiro de desktop gratuito e open-source para macOS que exibe um overlay de mascote animado ao lado das sessões do Claude Code. Ele rastreia a atividade da sessão em tempo real, aparece quando o Claude precisa de permissão ou atenção, e permite aprovar ou negar ações sem sair do seu fluxo de codificação.

O app roda como uma janela overlay leve e fornece um dashboard de observabilidade para cada sessão do Claude — mostrando status da sessão, feed de atividades e prompts de permissão — mantendo tudo local via sistema de hooks do Claude Code.

Principais Recursos

• Overlay de mascote para macOS no Claude Code: Um mascote flutua sobre outras janelas e atualiza com base no estado da sessão atual (ex.: ocioso, trabalhando, atenção).
• Gerenciamento de permissões em tempo real: Quando o Claude pede para executar um comando, o overlay oferece fluxo de permitir/negar pelo teclado, sem precisar trocar para o mouse.
• Dashboard de notificações: Um dashboard mostra instantâneos da sessão (ex.: executando/aguardando entrada/compactando), feed de eventos com cores e resumos da sessão.
• Rastreamento de subagentes: Monitora agentes filhos em tempo real para você ver o que está acontecendo além da sessão principal.
• Controles de sessão priorizando teclado: Inclui atalhos para trocar entre sessões, pular para a aba de terminal rodando Claude Code e confirmar ações de permissão.
• Comportamento local-first: O app usa o sistema de hooks do Claude Code para receber metadados de eventos (nomes de ferramentas e status da sessão), mas não lê seu código; roda localmente sem enviar código para servidor.

Como Usar Masko for Claude Code

1. Baixe e instale no macOS: Instale o app via DMG fornecido para macOS; o app fica na barra de menus, sem poluir o Dock.
2. Conceda acessibilidade uma vez: Na primeira execução, o app instala hooks do Claude Code automaticamente e pede permissão de acessibilidade para o overlay.
3. Inicie o Claude Code: Abra um terminal e rode o Claude Code normalmente para o app observar as sessões.
4. Interaja pelo overlay: Quando solicitado (ex.: Claude quer rodar um comando ou pergunta algo), use atalhos de teclado para aprovar/negar e focar a aba de terminal correta.
5. Escolha um mascote: Use um dos seis mascotes incluídos por padrão, ou carregue mascotes personalizados de masko.ai no app de desktop.

Casos de Uso

• Aprove comandos do Claude Code sem trocar de contexto: Quando o Claude pede permissão para rodar algo (ex.: comando de build), o overlay apresenta ações permitir/negar para confirmação rápida pelo teclado.
• Acompanhe o que o Claude faz em múltiplas sessões: Com alternador de sessões e pulo para terminal focado na sessão, gerencie várias sessões do Claude e vá direto à aba de terminal de cada uma.
• Revise atividade da sessão e chamadas de ferramentas: Use o dashboard de notificações para inspecionar eventos ordenados (chamadas de ferramentas e completos) e entender o que mudou na sessão ao longo do tempo.
• Lide com momentos “aguardando entrada”: Quando uma sessão indica espera por entrada, o dashboard e notificações ajudam a identificar esse estado e responder rápido.
• Rastreie atividade de agentes que dependem de subagentes: Se seu fluxo aciona agentes filhos, o rastreamento de subagentes mostra essas atividades em tempo real para seguir o caminho completo de execução.

FAQ

Masko for Claude Code é gratuito?
Sim. O companheiro de desktop é gratuito e open-source, licenciado sob MIT.

Masko requer servidor ou chaves de API?
Não. Não há arquivos de config, servidor ou chaves de API; tudo roda localmente.

O que Masko coleta e ele lê meu código?
Masko usa o sistema de hooks do Claude Code e recebe metadados de eventos como nomes de ferramentas e status da sessão. Não lê seu código.

Como funcionam os mascotes?
O app inclui seis mascotes por padrão. Você também pode criar ou trazer mascotes personalizados de masko.ai e carregá-los no app de desktop.

Masko pode me ajudar a pular para o terminal certo?
Sim. O overlay oferece atalho para focar instantaneamente a aba de terminal rodando Claude Code, e suporta terminais e editores mencionados na página (ex.: iTerm2, Terminal.app, VS Code, Ghostty).

Alternativas

• Abordagens nativas do terminal/editor (sem overlay): Confie nos prompts do Claude Code dentro do seu terminal ou IDE, respondendo no local. Isso difere por exigir que você mude o foco em vez de usar um overlay sempre ativo e painel.
• Ferramentas gerais de notificação/automação do macOS: Use roteamento de notificações ou automação por teclado para destacar prompts e ações. Isso é mais genérico e pode não oferecer observabilidade específica de sessões do Claude Code ou estado baseado em mascote.
• Outros overlays de produtividade para desenvolvedores: Procure ferramentas que forneçam rastreamento de sessões e navegação rápida para fluxos de trabalho de desenvolvimento. Elas geralmente focam em navegação de código ou histórico de chat, em vez de prompts de permissão do Claude Code e feeds de eventos de sessão.
• Fluxo de trabalho apenas CLI com verificações manuais de permissão: Opere o Claude Code pela linha de comando e revise comandos manualmente antes de executá-los. Isso oferece máxima simplicidade, mas falta visibilidade em tempo real do painel e aprovação com um clique/teclado do overlay.