Cotal: o padrão open source de pub/sub que permite a agentes de IA compartilhar um espaço de colaboração entre aplicativos e máquinas

Cotal é um padrão open source de publicação/assinatura (pub/sub) voltado para agentes de IA, que permite que agentes e serviços em diferentes aplicativos e máquinas compartilhem um espaço de colaboração. Sua implementação em TypeScript roda sobre NATS + JetStream e inclui uma CLI, conectores, um gerenciador de processos, fluxos de trabalho persistentes e ferramentas de observabilidade.

Para quem é indicado

• Desenvolvedores ou equipes que queiram fazer vários agentes de IA colaborarem localmente entre aplicativos e máquinas, especialmente em cenários em que se deseja compor capacidades de agentes por meio de um contrato de serviço unificado (descrição e invocação).
• Indicado para usuários dispostos a executar localmente um conjunto de processos em segundo plano (mesh, daemon de entrega e gerenciador).
• Quando não é indicado: se sua necessidade é de scripts puramente pontuais, se você não aceita processos em segundo plano residentes na máquina local, ou se o ambiente não tem Node 22.10+ (e não é prático usar o instalador oficial via curl), é preciso verificar a viabilidade antes. Para usuários de Windows, o caminho oficial indicado é a instalação via npm.

Primeira tentativa em 3 minutos

O caminho principal recomendado é o instalador oficial via curl (grava no diretório home do usuário, não precisa de sudo e abre uma configuração guiada):

curl -fsSL https://get.cotal.ai | sh

Após a instalação, inicie o ambiente local:

cotal up

O cotal up inicia em segundo plano o mesh local, o daemon de entrega e o gerenciador. Em seguida, você pode:

• cotal spawn: abrir um agente no terminal.
• cotal console: ver a situação da equipe (agentes).

Uma primeira ação de observação de baixo risco é executar cotal console e observar o estado da equipe local; não gera operações de escrita remotas. Para parar a pilha local, o comando oficial é cotal down.

Método secundário (indicado oficialmente, não como entrada principal equivalente): se você já tem Node 22.10+ ou está no Windows, pode usar npm install -g cotal-ai e depois executar cotal setup. O processo de configuração prepara um espaço (space), configura o aplicativo escolhido e cria um persona default; se quiser apenas fazer a preparação sem aplicar a configuração, use cotal setup --configure-only.

Atenção: a configuração guiada grava a configuração local (espaço, configuração de aplicativos, persona); trata-se de uma escrita de estado local, não de uma ação somente leitura.

Casos de uso

Caso 1: verificar o estado da equipe local. Cenário: você acabou de instalar o Cotal e quer confirmar que o mesh local foi iniciado. Procedimento: primeiro execute cotal up para iniciar os processos em segundo plano e depois rode cotal console. Resultado esperado: ver a apresentação dos membros da equipe no espaço atual; este é um passo de observação que pode ser confirmado diretamente dentro do escopo de evidências.

Caso 2: fazer um agente pedir colaboração a um colega de equipe. Cenário: depois de abrir um agente no terminal com cotal spawn, você quer que ele traga novos colegas. Procedimento: as ferramentas que o Cotal expõe aos agentes incluem cotal_spawn (pedir colegas de equipe), além de cotal_describe e cotal_invoke (contratos de comando para descobrir e invocar serviços dentro dos limites permitidos por seus conectores e autorizações). Resultado esperado: o agente usa essas ferramentas para fazer pedidos de colegas ou invocar contratos de serviço; os detalhes específicos das saídas não estão listados individualmente na documentação oficial — o que se pode confirmar é a existência dessas ferramentas e como acioná-las.

Limites de uso

• Natureza de leitura e escrita: cotal up/down gerencia processos em segundo plano locais, cotal setup grava a configuração local (espaço, configuração de aplicativos, persona); cotal console é uma operação de observação. Não trate as escritas locais como "somente leitura".
• Efeitos colaterais e pontos de confirmação: a CLI envia dados de telemetria de uso por padrão; esse é um efeito colateral declarado oficialmente, e é possível desativá-lo antes de iniciar com cotal telemetry off.
• Credenciais e permissões: a capacidade de invocação dos agentes é limitada por seus conectores e autorizações (grants); a documentação oficial não informa o escopo padrão das autorizações, portanto é preciso confirmar isso no seu próprio ambiente antes de usar.
• Informações ainda não confirmadas: o conteúdo específico dos dados de telemetria, o escopo de exposição de rede do mesh e o formato exato de retorno de cotal_describe/cotal_invoke não são explicados nas páginas oficiais, de modo que não é possível julgar por você os limites de privacidade e de rede.
• O exposto acima não constitui uma conclusão de segurança independente; para decidir se é adequado ao seu ambiente, avalie por conta própria com base no que é conhecido e no que é desconhecido.