Pular para o conteúdo
claudemods

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

Instale dentro do Claude Code:

/plugin install agent-tree --marketplace MikeGT4/agent-tree
Todas as opções de instalação ↓

O 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. 1.Uma linha, dentro do Claude Code

    /plugin install agent-tree --marketplace MikeGT4/agent-tree

    Cole em uma sessão em andamento (v2.1.275+). O Claude Code pede primeiro para adicionar o marketplace.

  2. 2.Pelo seu shell

    claude plugin marketplace add MikeGT4/agent-tree
    claude plugin install agent-tree@agent-tree

    Depois execute /reload-plugins em qualquer sessão que já esteja aberta.

  3. 3.Experimente sem instalar

    git clone https://github.com/MikeGT4/agent-tree
    claude --plugin-dir ./agent-tree

    Carrega 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 language e advisorModel, e os valores de contexto e custo.
  • Telemetria: nenhuma.
  • Hooks de controle: agent.spawn adiciona o modelo que você escolheu aos novos subagentes que não indicam nenhum, turn.step troca 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, e tool.call recusa 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 ferramenta SubagentHandback com 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.
Agent Radar em execução no Claude CodeDestaque

Agent 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

Agent Profiler em execução no Claude CodeDestaque

Agent 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

Mais em Painéis e dashboards, Timers, tarefas e standups.