Agent Radar: um monitor de subagentes do Claude Code acima do prompt

O Agent Radar é um mod da comunidade de Hamza Zafar (hamzafer), parte da coleção claude-code-mods dele. É um monitor de subagentes do Claude Code: quando o Claude delega trabalho a um subagente, a faixa acima do prompt ganha uma linha ao vivo para ele, e você vê o que cada um está fazendo sem abrir nada.

Uma linha tem este aspecto: ● Read README and all src/ files 4s · 2 tools · searching src/**/*. Ela traz a descrição do agente, o tempo decorrido, quantas chamadas de ferramenta ele fez e um rótulo simples da última. Quando o agente termina, o ponto vira um check verde por 30 segundos e aparece um toast como ✓ sweep runner done (9s · 4 tools). Um agente que falhou ou foi abortado recebe um X vermelho e o motivo.

O /radar abre um painel chamado «Agent Radar». Ele lista até nove agentes, cada um com uma tecla de atalho, mostra quantos estão rodando e quantos terminaram, e deixa você abrir um para ver suas últimas seis mensagens. O painel tem um botão «Clear finished». Agentes que começaram antes de o mod carregar são incluídos a partir da lista de agentes do próprio motor quando você executa /radar. O mod não mostra contagem de tokens nem custo.

A gravação mostra o Claude Code 2.1.291 com Haiku em um pequeno projeto de demonstração. Pedimos ao Claude que use um subagente Explore chamado scan src para ler o README.md e cada arquivo de src/. O Claude o inicia como agente em segundo plano e uma linha amarela aparece de imediato acima do prompt: ● scan src 4s · 2 tools · searching src/**/*. O tempo e a contagem de ferramentas sobem a cada segundo, e o rótulo muda para reading src/login.js conforme o subagente passa de um arquivo para o próximo.

O bloco de instalação acima adiciona o marketplace do autor e instala o plugin a partir dele. A faixa aparece na próxima vez que um subagente iniciar. Se você instalou em uma sessão que já está aberta, execute /reload-plugins.

O mod guarda o estado do radar em três átomos $.state mantidos pelo host (agents, selected, now), por isso ele sobrevive a um hot reload. Quatro hooks o alimentam. agent.spawn adiciona uma entrada, tool.call conta as chamadas de ferramenta que trazem um agentId, e turn.complete marca o agente como concluído ou com falha e dispara o toast. Um relógio de um segundo, iniciado em session.start, redesenha os tempos decorridos enquanto alguma linha estiver visível. O hook de chamadas de ferramenta, de hooks/register.tsx:

on('tool.call', async ($, e, next) => {
  if (e.agentId) {
    const id = e.agentId
    const line = describe(e as unknown as Record<string, unknown>)
    await update($, agents, list => list.map(a => (a.id === id ? { ...a, tools: a.tools + 1, last: line } : a)))
  }
  return next(e)
})

Ele atualiza o contador antes de deixar a chamada rodar e depois devolve o resultado de next(e) intacto. Chamadas do agente principal, que não têm agentId, são ignoradas. describe transforma uma chamada em um rótulo curto: reading e editing mais os dois últimos segmentos do caminho, searching mais os primeiros 30 caracteres de um padrão, running mais uma descrição do Bash ou os primeiros 50 caracteres do comando, e browser: click para as ferramentas do Playwright. A faixa é desenhada no ponto de renderização AbovePrompt, depois do conteúdo que outros mods e o Claude Code colocam ali, e dá lugar enquanto uma pesquisa estiver aberta.

Não há opções em /config. Para mudar o visual, edite as constantes no topo de register.tsx: SHOW_DONE_MS (quanto tempo uma linha concluída permanece, 30 segundos) e BAND_ROWS (quantas linhas a faixa mostra, 4). A lista de agentes é limitada a 30 entradas no hook agent.spawn, e as cores e os glifos são definidos nas funções icon e color.

Lemos todos os arquivos que o plugin carrega antes de executar qualquer coisa: .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, types/index.d.ts e o arquivo de testes. Não há package.json, script de instalação, binário nem código empacotado, e não encontramos caracteres ocultos ou de largura zero. O repositório tem um LICENSE MIT.

Altera a interface abrange a faixa, o painel e os toasts. Adiciona um comando abrange o /radar. O mod não usa rede, comandos de shell, gravação de arquivos nem variáveis de ambiente, e não guarda nada fora do estado do host do Claude Code, que fica na memória. Ele não inicia nenhum serviço em segundo plano: o relógio de um segundo pertence à sessão e só roda enquanto uma linha de agente está visível. Não adiciona nada aos prompts nem aos resultados de ferramentas e nunca chama o modelo.

Os pontos que merecem atenção são estes. O mod se prende a todo tool.call e agent.spawn sem matcher, então vê nomes e entradas de ferramentas dos subagentes, como um comando Bash ou um caminho de arquivo, e mantém na memória um rótulo curto do mais recente. Ele não os salva nem os envia. No painel, abrir um agente lê suas mensagens recentes por $.session.messages e as mostra localmente, cortadas em 400 caracteres cada. Por fim, o claude plugin validate não relatou erros nem avisos, mas observou que os hooks agent.spawn e tool.call não têm .catch. Os dois hooks repassam o evento com next(e), então o risco prático é um erro lançado por uma atualização de estado, não um bloqueio. Os 2 testes do autor passaram no Claude Code 2.1.291.

Verificado com o Claude Code 2.1.291 no macOS (validate e testes). Se a faixa não aparecer:

• Um subagente precisa iniciar na sessão atual; a faixa só lista agentes cujo início ela viu. Execute /radar para incluir os que começaram antes.
• Há uma pesquisa aberta acima do prompt; a faixa volta quando ela fechar.
• Outro plugin já é dono do /radar. O Claude Code recusa o nome e o mod segue em frente sem o comando.
• Instalado em uma sessão aberta: execute /reload-plugins.

O rodapé «Agent view» do Claude Code é separado deste mod e mostra sua própria lista de agentes abaixo do prompt.