Toda equipe que executa agentes de programação em escala acaba precisando dos mesmos componentes: uma fila de trabalho, um git worktree por agente, supervisão de processos de longa duração, executores de verificação, um local para revisar diffs, controle financeiro de custos e memória para que os agentes parem de cometer os mesmos erros repetidamente. Muitas equipes tentam construir isso internamente, começando com um script em shell em torno do Claude Code ou da Codex CLI. O Ivy Tendril reúne todas essas peças prontas em um aplicativo de desktop gratuito, com código disponível (source-available), que roda na sua máquina com qualquer agente CLI. Construa sua própria solução quando a orquestração for o seu produto principal ou quando o seu fluxo de trabalho for tão incomum que nenhum ciclo de vida estruturado se encaixe. Use o Tendril quando quiser ter tudo funcionando ainda esta semana e preferir que o fardo da manutenção fique com outra pessoa.
Para que serve cada abordagem
Uma orquestração desenvolvida internamente costuma nascer como uma conveniência imediata: um script que cria uma branch, inicia um agente passando um prompt e abre um pull request quando o processo finaliza. A complexidade aumenta quando a equipe precisa rodar vários agentes simultaneamente, quer acompanhar o que estão fazendo em tempo real e precisa apurar os custos envolvidos. Após alguns meses, o resultado é uma ferramenta interna pesada com seu próprio backlog de pendências. A literatura acadêmica sobre frameworks multiagente — incluindo o AutoGen — descreve rigorosamente esses mesmos blocos, evidenciando que são necessidades intrínsecas ao problema e não particularidades de um projeto isolado.
O Ivy Tendril é voltado para equipes que buscam os resultados dessa ferramenta sem ter de arcar com os custos do seu desenvolvimento. Ele opera segundo um ciclo de vida consolidado: ideia ou ticket, geração do plano, rascunho (draft), revisão humana do plano, Expand, Split ou Update, execução em worktrees isolados, verificação por testes, linter e diff, revisão humana do diff, pull request e merge. Existem exatamente dois pontos de controle humano — o plano e o diff — e nada é integrado sem aprovação formal. Funciona como aplicativo de desktop para macOS, Windows e Linux, ou em modo headless via tendril --web, compatível com qualquer agente CLI e suas próprias chaves de API.
Comparação
| Aspecto | Ivy Tendril | Orquestração interna (DIY) |
|---|---|---|
| Fila de trabalho | Visualizações de Plans, Drafts, Icebox e Recommendations | Você projeta e programa do zero |
| Isolamento por worktree | Automático, um worktree e uma branch por plano | Criação, nomenclatura e limpeza manual via scripts |
| Supervisão de processos | Visualização Jobs com streaming e logs detalhados | Tratamento manual de timeouts, retentativas e falhas |
| Verificação | Testes, linting e diff por plano; integração CI no Pro | Conexão manual de executores à saída de cada agente |
| Revisão | Visualização Review com abas dedicadas para diff e testes | Apenas pull request bruto ou interface própria |
| Gestão de custos | Por plano e por tarefa, com métricas no Dashboard | Extração de tokens a partir do formato de cada agente |
| Memória | Promptware Memory/ por fase, alimentada pelos agentes | Projeto próprio de armazenamento, busca e injeção |
| Suporte a agentes | Qualquer agente CLI, configurável por plano | Cada agente precisa ser integrado e mantido à mão |
| Customização | Programas, ferramentas e memória Promptware; API REST; código aberto | Total e irrestrita |
| Manutenção | Atualizações frequentes lançadas pela Ivy | Sua equipe de engenharia, continuamente |
| Preço | Gratuito; Pro a 59 USD por usuário/mês | Horas de desenvolvimento interno |
O que uma orquestração própria exige
Antes de começar a programar uma solução do zero, vale a pena compreender como os quatro padrões de orquestração se sucedem, já que a maioria das ferramentas internas acaba por redescobri-los na mesma ordem.
Uma fila de tarefas. Demandas chegam por tickets, relatos de erros ou mensagens de chat; algum sistema precisa armazená-las, ordená-las e distribuí-las aos agentes. No Tendril, as telas Plans, Drafts e Icebox desempenham esse papel, com entrada facilitada por webhooks, um servidor MCP, uma API REST e uma CLI.
Gerenciamento de worktrees. Dois agentes editando o mesmo diretório de trabalho fatalmente sobrescreverão o código um do outro. Cada tarefa exige seu próprio git worktree em uma branch exclusiva, criado antes do início do agente e removido após o merge do pull request. O Tendril automatiza isso para cada plano. Veja mais em git worktrees para agentes de IA paralelos.
Supervisão de processos dos agentes. Agentes CLI rodam por minutos ou horas, pedem confirmações de permissão, sofrem restrições de chamadas (rate limits) e às vezes travam. É preciso um processo supervisor para iniciá-los com as flags adequadas, capturar a saída, detectar bloqueios e registrar o histórico completo. A visualização Jobs do Tendril exibe a saída em tempo real e armazena registros minuciosos de execução.
Executores de verificação. Um agente alegar que concluiu a tarefa com êxito não prova nada. Testes automatizados, verificação de estilo (lint) e análise do diff precisam rodar no worktree antes que um humano dedique tempo à revisão. O Tendril executa essa rotina para cada plano e centraliza os resultados na visualização Review. Veja barreiras de verificação para código gerado por IA.
Uma interface de revisão dedicada. A página padrão de pull request exibe um diff, mas não indica quais validações foram executadas nem quanto a execução do agente custou. Avaliar dez diffs por dia pelo navegador é viável; avaliar cinquenta torna-se inviável. A tela Review do Tendril coloca o diff e os testes de validação no mesmo espaço.
Gestão financeira de custos. Cada agente reporta o consumo de tokens em um padrão diferente, quando reporta. Para conhecer o custo de uma tarefa, é preciso contabilizar o consumo de cada execução, calcular o preço e consolidar por entrega. O Tendril calcula tokens e valores por plano e por tarefa, exibindo essas métricas no Dashboard.
Memória. Sem memória, toda execução parte do zero. Com memória, você precisa estruturar o armazenamento, uma rotina para registrar aprendizados após a execução e uma estratégia para injetar o contexto pertinente antes da tarefa seguinte. No Tendril, cada etapa é um módulo promptware com Program.md, pasta Memory/, ferramentas restritas em Tools/ e Logs/. Os agentes documentam seus aprendizados e refinam suas próprias instruções. Confira promptware: agentes que aprimoram as próprias instruções.
O custo real da manutenção
O desenvolvimento do código inicial é a parte mais barata. O custo real surge porque cada bloco citado acima depende de tecnologias que mudam sem parar. Agentes CLI lançam versões frequentes, alterando argumentos de linha de comando, formatos de saída e modelos de permissões. Provedores de IA adicionam e depreciam modelos com rapidez. Seu repositório evolui e exige novas checagens de validação. Cada alteração é pontual, mas o efeito acumulado transforma a manutenção em um encargo contínuo para ao menos um engenheiro da equipe.
Há também o custo de oportunidade de recursos que nunca são desenvolvidos: anotações no plano em tempo real, divisão de planos (plan splitting), controle por voz, acompanhamento pelo celular e telas de recomendações exigem esforço substancial de design e engenharia, raramente sendo viabilizados em projetos internos.
Pontos de controle humano e sua importância
Um fluxo caseiro costuma possuir um único controle: o pull request, justamente porque já existe por padrão. O Tendril adota dois. O ponto de controle no plano permite retificar o escopo antes que o agente gere código, comentar diretamente em rascunhos para reescrever planos ou particionar planos complexos demais. Implementar esse controle em uma solução interna exige criar um formato estruturado de planos, uma etapa de rascunho, um editor visual e a injeção do plano validado no agente.
Paralelismo, escolha de agentes e gestão orçamentária
A execução paralela é o gargalo que mais drena horas de manutenção em soluções internas: remoção de worktrees órfãos, conflitos de portas em suítes de testes concorrentes e instabilidades em um agente que derrubam tarefas paralelas. O Tendril isola cada plano em seu próprio worktree e branch, mantendo a branch principal impecável até a validação final.
Integrar um agente é uma meta alcançável; manter cinco integrados e funcionais é um trabalho sem fim. O Tendril permite alternar agentes ou modelos a cada plano sem precisar mexer no restante da sua estrutura, suportando chaves próprias para Anthropic, OpenAI, Google, OpenRouter e outros. O cálculo de custo por plano possibilita comparar o desempenho e o custo de modelos diferentes na mesma tarefa.
Quando construir sua própria solução é a melhor escolha
- A orquestração é o produto central da sua empresa e você precisa controlar cada detalhe da mecânica de execução.
- O seu ciclo de trabalho não finaliza em um pull request, não emprega git ou manipula ativos diferentes de código-fonte.
- Você quer um fluxo sem nenhuma intervenção humana (por exemplo, alterações autônomas em repositórios sem impacto crítico) e tolera que modificações passem sem revisão.
- Você faz parte de um grupo de pesquisa e a modificação do ciclo em si é o experimento em andamento.
Quando o Ivy Tendril é a melhor escolha
- Você quer agentes paralelos, isolamento via worktrees, verificação, revisão e acompanhamento financeiro operando já nesta semana.
- Você precisa de dois pontos de controle humano sem ter que programar editores de planos nem interfaces de revisão.
- Você quer uma memória de agentes cumulativa sem precisar estruturar o sistema de persistência.
- Você prefere que a compatibilidade contínua com novos agentes seja de responsabilidade da Ivy. O aplicativo é gratuito; confira os preços dos planos Pro e Enterprise.
Confira também padrões de orquestração para agentes de código.
Perguntas frequentes
Posso estender o Ivy Tendril em vez de criar algo do zero?
Sim. Cada fase do ciclo de vida é um módulo promptware com arquivos Program.md, Memory/ e Tools/ acessíveis e editáveis. A API REST, o servidor MCP e a CLI permitem conectar o Tendril diretamente às ferramentas internas da sua empresa. O código-fonte é disponibilizado sob os termos da FSL-1.1-ALv2.
O Ivy Tendril me prende a um único agente ou modelo?
Não. O Tendril funciona perfeitamente com Claude Code, OpenAI Codex CLI, GitHub Copilot CLI, Google Gemini CLI, OpenCode e outros agentes de linha de comando. Você utiliza suas próprias chaves de API e seleciona os recursos livremente por plano.
Já possuo uma solução interna. Posso rodar ambas em paralelo?
Sim. Você pode direcionar um conjunto selecionado de tarefas para o Tendril por meio de webhooks ou da API REST e contrastar a taxa de pull requests aprovados e o custo por tarefa com os parâmetros que você obtém hoje.
Primeiros passos com o Ivy Tendril
Pronto para a orquestração paralela de agentes em nível de engenharia?
- Explore o código: Confira o Ivy Tendril no GitHub (Código aberto).
- Consulte a documentação: Encontre guias de integração em tendril.ivy.app.
- Agende uma sessão técnica: Entre em contato pelo e-mail renco@ivy.app para uma consultoria de arquitetura de 30 minutos.