Agent Tree: a árvore de subagentes do Claude Code em caixas
Um painel lateral que desenha os subagentes como caixas, com a sessão principal, o consultor e um registro da sessão.
Permissões
- Intercepta chamadas de ferramentasVê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
- Lê seus promptsPode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
- Altera a interfaceDesenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
- Adiciona comandos/ferramentasRegistra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
- testado com
- v2.1.310
- último teste
- requer
- Claude Code ≥ 2.1.287
- superfícies
- painel, status
- código-fonte
- Mike Pollow, Digitalroots (MikeGT4) (MIT)
Instale dentro do Claude Code:
/plugin install agent-tree --marketplace MikeGT4/agent-treeO que este mod faz?
O Agent Tree é um mod da comunidade de Mike Pollow, Digitalroots (MikeGT4). Ele mostra a árvore de subagentes do Claude Code em um painel lateral, desenhada com caixas. No topo fica a sessão principal, com modelo, nível de esforço, uso de contexto e número da rodada. Abaixo, cada subagente tem uma caixa com tipo, modelo, descrição, última ferramenta, uma linha de status e uma barra de tempo. Uma última caixa marca o caminho de volta para a sessão principal e conta as respostas devolvidas.
Ao lado da árvore, uma coluna do consultor mostra se há um modelo consultor configurado, quantas vezes ele foi consultado, pela sessão principal ou por subagentes, e quando foi a última vez. Na parte de baixo, um registro da sessão lista as rodadas, inícios e términos de agentes, chamadas ao consultor e as suas próprias escolhas. Quando muitos agentes rodam, o painel passa para linhas compactas, e um workflow com muitos agentes é recolhido em uma só caixa.
O painel também é uma superfície de controle. Clique no tipo de um agente para ver a tarefa, as ferramentas recentes e a última resposta, e para pará-lo. Você pode escolher uma família de modelos para os novos subagentes ou para um agente em execução. Só nesses casos o mod muda o que o Claude Code faz. A linha de status também recebe um resumo curto como Sub-agents [1/1] · $0.00. O autor testou com o Claude Code 2.1.296 e de 2.1.307 a 2.1.310.
Demonstração
A gravação inicia o Claude Code com o mod carregado no pequeno projeto de demonstração e executa /agent-tree, que abre o painel: a sessão principal está ociosa, ainda não há subagentes e o registro está vazio. Em seguida pede ao Claude que use um subagente para ler src/login.js e descrevê-lo em uma frase. O painel muda para WORKING, o registro ganha uma linha "Round 1" e um subagente general-purpose aparece em execução, com a sessão principal "aguardando os subagentes" e o número de contexto se preenchendo. Quando o agente termina, a resposta dele é contada na caixa "back to main session".
Instalação
Use qualquer um dos métodos do bloco de instalação; eles instalam direto do marketplace do próprio autor. Depois, execute /agent-tree para abrir o painel.
$ install agent-tree
Requer Claude Code ≥ 2.1.287
Instala a partir do marketplace do autor: MikeGT4/agent-tree
1.Uma linha, dentro do Claude Code
/plugin install agent-tree --marketplace MikeGT4/agent-treeCole em uma sessão em andamento (v2.1.275+). O Claude Code pede primeiro para adicionar o marketplace.
2.Pelo seu shell
claude plugin marketplace add MikeGT4/agent-tree claude plugin install agent-tree@agent-treeDepois execute /reload-plugins em qualquer sessão que já esteja aberta.
3.Experimente sem instalar
git clone https://github.com/MikeGT4/agent-tree claude --plugin-dir ./agent-treeCarrega o mod só para uma sessão. Nada é adicionado às suas configurações.
Como funciona
O mod guarda a árvore em um átomo de estado e escuta os eventos de agentes: agent.spawn adiciona um nó, tool.call conta ferramentas, turn.step registra modelo, esforço e uso do consultor, e turn.complete marca um agente como concluído, com falha ou parado. ui.render desenha o painel a partir desse estado. Um temporizador de 250 ms anima o indicador somente enquanto um agente trabalha. A função de parar é a parte que bloqueia chamadas de ferramentas, em hooks/register.tsx:
if (stoppingIds.has(agentId)) {
if (e.tool !== HANDBACK) {
const current = await read($, tree)
return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
}Só é afetado um agente que você pediu para parar. O texto vindo da sessão (tarefa, respostas, rótulos de ferramentas) é limpo antes de ser desenhado: escapes de terminal e caracteres de controle são removidos, e textos que parecem tokens, senhas ou pares KEY=value são trocados por •••. Os rótulos de ferramentas mostram um nome de arquivo, de programa ou um host, não o comando inteiro.
Personalize
O /config oferece cinco opções: largura do painel acoplado (90 colunas por padrão, de 40 a 140), quantos subagentes a árvore mantém (30 por padrão), abrir ao iniciar (desligado por padrão), movimento (animação do indicador e do fluxo, ligado por padrão) e idioma (auto, de, en). Uma largura arrastada à mão tem prioridade. Teclas dentro do painel: m para escolher o modelo, 0 a 4 para escolher, x para fechar, s para parar na vista de detalhes e ctrl+x tab para focar o painel.
Permissões e segurança
Lemos todos os arquivos que o plugin pode executar: hooks/hooks.json, register.tsx, model.ts, view.tsx, words.ts, as declarações de tipos, os testes, o README e o PRIVACY.md. Não há package.json, script de instalação, binário nem código empacotado. O único arquivo que não é texto é um ícone PNG.
- Rede, processos, arquivos, daemons, segredos: nenhum. Não encontramos chamadas de rede, comandos de shell, gravação de arquivos, variáveis de ambiente nem acesso a credenciais, e nada continua rodando depois que o Claude Code fecha. O temporizador para quando nenhum agente está ocupado.
- Lê: a lista de agentes e as mensagens dos subagentes (para a vista de detalhes), suas configurações
languageeadvisorModel, e os valores de contexto e custo. - Telemetria: nenhuma.
- Hooks de controle:
agent.spawnadiciona o modelo que você escolheu aos novos subagentes que não indicam nenhum,turn.steptroca o próximo passo de um agente em execução para o modelo escolhido ou o substitui por um breve relatório quando você pressiona parar, etool.callrecusa novas chamadas de ferramentas de um agente parado. Os três só agem depois que você clica no painel, o que confere com o README e o PRIVACY.md. O relatório de parada é uma mensagem sintética do assistente que inclui uma chamada da ferramentaSubagentHandbackcom um id aleatório. - Injeção de prompt: não encontramos. O mod não adiciona texto aos prompts e não contém Unicode oculto.
- Licença: MIT, com arquivo LICENSE.
O claude plugin validate não reportou erros nem avisos; ele observa que o diretório de plugins tem regras próprias para módulos de hooks que o validate não aplica. Os 63 testes do autor passaram no Claude Code 2.1.310.
- Intercepta chamadas de ferramentas
- Vê cada chamada de ferramenta que o Claude faz (tool.call / tool.check) e pode bloqueá-la ou alterá-la.
- Lê seus prompts
- Pode ver o que você digita e a transcrição da conversa (prompt.* / session.append / session.messages).
- Altera a interface
- Desenha na interface do Claude Code: faixas, painéis, texto de status, notificações (ui.render / $.ui.*).
- Adiciona comandos/ferramentas
- Registra novos comandos de barra ou ferramentas que você ou o Claude podem acionar ($.command.register / $.tool.register).
Compatibilidade e solução de problemas
Verificado com o Claude Code 2.1.310 no macOS (validate, testes e a gravação). É preciso ter a interface de mods. Se o painel não aparecer:
claude --versioné 2.1.287 ou posterior.- Você executou
/agent-tree; o painel não abre sozinho. Quando funciona, o comando mostra "Agent Tree opened". - O terminal é largo o bastante: abaixo de 84 colunas a coluna do consultor fica empilhada sobre a árvore, e abaixo de 40 colunas de largura do painel o layout fica apertado.
- Agentes iniciados antes de o mod carregar são incorporados da lista de agentes quando você abre o painel.
- O painel não mostra nada em uma sessão sem subagentes: ele diz "no sub-agents yet".
Perguntas frequentes
- O Agent Tree envia dados ou faz requisições de rede?
- Não. O código não tem chamadas de rede e o PRIVACY.md do autor diz que nada sai da máquina. Ele mantém a árvore só na memória durante a sessão em andamento e não grava arquivos.
- Posso parar um subagente em execução pelo painel?
- Sim. Clique no tipo do agente para abrir os detalhes e pressione parar (ou a tecla s). As próximas chamadas de ferramentas desse agente são recusadas e o passo seguinte devolve um breve relatório de "parado pelo usuário".
- Posso trocar o modelo de um subagente?
- Sim. O botão Modelo define a família de modelos (Haiku, Sonnet, Opus ou Fable) para os novos subagentes, e o botão na caixa de um agente em execução troca os próximos passos dele. Um modelo que a própria chamada indica não é alterado.
- O painel fica sempre aberto?
- Não por padrão. /agent-tree abre, /agent-tree stop fecha e /agent-tree clear recomeça a árvore. A configuração "Abrir ao iniciar" abre o painel em toda sessão.
- Os rótulos estão em inglês?
- Por padrão seguem a configuração de idioma, alemão ou inglês. A opção Language pode forçar de ou en. Os horários do registro aparecem no formato de 24 horas.
# Mods relacionados
DestaqueAgent Radar
Uma linha ao vivo acima do prompt por subagente em execução: tempo, ferramentas e ação atual, mais um painel /radar.
- acima do prompt
- painel
- notificação
- Intercepta chamadas de ferramentas
- Lê seus prompts
- Altera a interface
- Adiciona comandos/ferramentas
testado com v2.1.291
DestaqueAgent Profiler
Para onde vai o tempo de uma sessão do Claude Code: modelo, ferramentas, subagentes, ao vivo. Com exportação OTLP.
- status
- painel
- notificação
- Grava arquivos
- Rede
- Intercepta chamadas de ferramentas
- Altera a interface
- Adiciona comandos/ferramentas
testado com v2.1.303