AI Maestro: guia seguro de introdução ao painel de orquestração multiagente

Para quem é

• Para desenvolvedores que usam vários agentes de codificação com IA ao mesmo tempo (como Claude Code, Codex, Grok Build etc.) e querem gerenciar as sessões desses agentes em um único painel web, em vez de alternar entre vários terminais.
• Para usuários que desejam que os agentes tenham recursos estendidos, como busca em memória, consulta a grafos de código e comunicação por mensagens entre agentes.
• Pré-requisito de uso: a instalação é feita na sua máquina com um único comando de shell; como o aplicativo não tem autenticação na camada de aplicação, ele deve ser usado apenas em uma rede confiável (por exemplo, uma rede interna via Tailscale), e a porta 23000 não pode ser exposta a redes não confiáveis. Se você não puder garantir o perímetro de rede ou não aceitar esse modelo de segurança, esta ferramenta não é adequada para você.
• As evidências oficiais não indicam os requisitos mínimos de sistema operacional nem os requisitos de versão dos agentes; essas informações são desconhecidas por enquanto.

Primeira tentativa em 3 minutos

O caminho principal recomendado é a instalação via shell remoto indicada na documentação oficial:

curl -fsSL aimaestro.sh | bash

1. Pré-requisito: uma máquina capaz de executar shell, dentro de uma rede confiável sob seu controle.
2. Instalação: execute o comando acima no terminal. Ele roda o script oficial de remote-install. Atenção: trata-se de baixar e executar um script da rede; antes de instalar, confirme que você confia nessa origem.
3. Após a instalação: uma vez iniciado, ele oferece uma interface de terminal baseada na web, gerenciando as sessões dos agentes de IA via tmux (terminal xterm.js + node-pty + saída em streaming via WebSocket).
4. Para a primeira tentativa, recomenda-se escolher uma tarefa de baixo risco: abra uma sessão de agente existente no painel e peça uma análise somente leitura, por exemplo, resumir a estrutura de um arquivo de código. Quais tarefas um agente específico suporta depende do próprio agente; as evidências oficiais não listam isso.
5. Sinal de sucesso: você consegue ver, no navegador, a saída em tempo real da sessão de terminal desse agente, e o agente entrega o resultado da análise. Se o painel exibir várias sessões de agentes ao mesmo tempo, isso também indica que a orquestração está funcionando.

A documentação oficial também menciona que é possível gerenciar vários agentes a partir de um único painel, mas não descreve outros métodos de instalação; este guia mantém apenas o caminho oficial acima.

Casos de uso

Caso 1: visualizar várias sessões de agentes em um só lugar. Cenário: você está executando o Claude Code e outro agente ao mesmo tempo e quer vê-los na mesma interface. Como fazer: após instalar e iniciar, abra o painel no navegador e conecte as sessões de agentes que deseja gerenciar (a documentação oficial explica que as sessões são gerenciadas via tmux). Resultado esperado: ver a saída em tempo real de cada sessão em terminais xterm.js em uma única interface web.

Caso 2: pedir a um agente uma análise de código somente leitura. Cenário: você quer verificar se o ambiente de orquestração funciona, sem deixar o agente modificar nenhum arquivo. Como fazer: envie uma instrução a um agente no painel, por exemplo: "analise a estrutura de um arquivo no diretório src e resuma". Recursos utilizados: a própria sessão de terminal do painel; se haverá chamadas à busca em memória ou à consulta a grafos de código depende das habilidades carregadas pelo agente, e as evidências oficiais não indicam o que é carregado por padrão. Resultado esperado: o agente exibe o texto da análise no terminal; sem operações de modificação de arquivos, trata-se de uma tarefa observacional e reversível.

Limites de uso

• Rede: o aplicativo, por padrão, faz bind em 0.0.0.0 e não tem autenticação na camada de aplicação; o modelo de segurança é "a rede é o perímetro de confiança", e a documentação oficial exige usá-lo junto com um perímetro de rede como o Tailscale; a porta 23000 não deve ser exposta a redes não confiáveis.
• Efeitos colaterais e pontos de confirmação: a instalação executa um script remoto; as sessões de agentes podem executar comandos ou acessar arquivos, e o comportamento específico depende do agente conectado. As evidências oficiais não indicam restrições adicionais deste aplicativo sobre as operações dos agentes; informações desconhecidas não devem ser tratadas como "sem risco".
• Ambiente de execução: é necessário o tmux e um navegador com suporte a WebSocket; as evidências oficiais não listam requisitos de sistema operacional.
• Limitação oficial explícita: a ausência de autenticação no nível da aplicação é uma decisão de design, não há evidência de que seja uma opção configurável.
• Ainda não confirmado: o intervalo de idiomas de texto/agentes suportados, a lista completa de clientes suportados e os procedimentos de atualização e desinstalação — as evidências oficiais não abordam nenhum desses pontos.