AgentValley para monitorar Claude Code no Mac

Para que serve o AgentValley, em termos simples?

AgentValley é um aplicativo gratuito e de código aberto que reúne sessões locais do Claude Code em um painel sob o notch do MacBook. Em termos simples, funciona como uma pequena central de acompanhamento: mostra qual agente está trabalhando e qual espera uma resposta sem precisar visitar cada terminal. Cada agente recebe uma linha e um personagem em pixels, inclusive os subagentes. É necessário ter Claude Code e macOS 15 ou posterior.

Entenda custos, tokens e limites

O botão de gráfico abre History. Escolha dia, semana ou mês e aprofunde a análise por hora ou por sessões do projeto. Os valores usam preços de API: são úteis para comparar consumo, mas não representam automaticamente a fatura de uma assinatura. O PDF pode abranger todos os projetos ou apenas um. O histórico continua no Mac mesmo após a limpeza de arquivos antigos do Claude Code.

O painel também mostra tokens das últimas cinco horas e do dia, com gráfico de doze horas. “Plan limits” vem desativado; ao ligar, aparecem limites de cinco horas e semanais com o tempo até a renovação. Verificado em 25 de outubro de 2026: o aplicativo é gratuito, com patrocínio voluntário. O acesso ao Claude Code segue condições próprias.

Veja qual agente precisa de você

As sessões ficam agrupadas por projeto, incluindo os worktrees correspondentes. Cada cartão mostra a tarefa, o modelo e a última etapa; as linhas dos subagentes também contam as etapas realizadas. Assim, fica mais fácil distinguir uma exploração delegada do trabalho principal.

Uma contagem vermelha avisa que há uma pergunta ou pedido de permissão. Abra o painel para ler e vá para o aplicativo da sessão. Com “Go to the session’s tab”, Terminal e iTerm2 abrem a aba correta. No Ghostty, duas sessões na mesma pasta podem tornar a seleção ambígua. Os sons vêm ligados e podem ser desativados ou trocados por um aviso simples.

Instale e acompanhe uma sessão

1. Baixe o DMG oficial, arraste AgentValley para Aplicativos e abra o app. Outra opção é brew install --cask morsechimwai/tap/agent-valley.
2. Inicie uma sessão Claude Code, aponte para o notch e confira o projeto e a última ação.
3. Use Control–Option–Command–A a partir de outro app, selecione uma linha com as setas e pressione Return para voltar à sessão.
4. Para responder pelo painel, ative “Answer from the notch”, execute o comando do plugin mostrado nos ajustes e reinicie Claude Code. Leia a solicitação antes de escolher “Allow once” ou “Deny”.

O plugin de respostas é opcional e exige instalação manual.

Dados locais e recursos opcionais

A descrição pública informa que lê ~/.claude/projects, ~/.claude/sessions, processos e informações Git dos projetos. Os dados do app ficam em ~/Library/Application Support/AgentValley. Ao ativar “Plan limits”, ele lê o login Claude Code no Chaves e o envia a api.anthropic.com. A consulta diária de atualizações ao GitHub pode ser desligada.

A linha de status opcional do terminal modifica ~/.claude/settings.json, instala uma fonte e acrescenta uma linha à configuração do Ghostty quando aplicável. Um comando de remoção desfaz essas alterações. O uso de arquivos locais não equivale a uma promessa de ausência de rede em todas as configurações.

Quando vale a pena usar

É especialmente útil para quem mantém várias sessões locais e precisa achar rapidamente a que está esperando. Os ajustes permitem mover o painel para um monitor conectado. O estado “quiet” significa dois minutos sem atividade escrita, não uma porcentagem de progresso ou um travamento confirmado. O escopo documentado é Claude Code no Mac. O código do aplicativo tem licença MIT e o projeto é independente da Anthropic.

Perguntas frequentes

O AgentValley é gratuito?

Sim. O app é gratuito e de código aberto, com apoio financeiro opcional. As condições de acesso ao Claude Code são separadas.

O custo mostrado é a minha fatura?

Não. É uma estimativa baseada em preços de API. Seu pagamento real depende do plano ou da forma de cobrança usada.

Preciso de plugin para acompanhar sessões?

Não para a visualização comum. O plugin é instalado manualmente para permitir ou negar solicitações diretamente no painel.

Downloads e suporte oficiais

• Versões e downloads oficiais
• Código-fonte e instruções de configuração
• GitHub Issues para problemas e sugestões