Workflow de Codificação com TMUX e AI Autônoma
Crie um sistema de agentes AI que codificam simultaneamente, em paralelo e sem intervenção humana, utilizando Claude Code, TMUX e agendamento de terminal.
Por que isso é importante
Workflow de Codificação com TMUX e AI Autônoma. Crie um sistema de agentes AI que codificam simultaneamente, em paralelo e sem intervenção humana, utilizando Claude Code, TMUX e agendamento de terminal.
O Avanço dos Agentes de Codificação
Do Cursor, que foi pioneiro em integrar AI ao VS Code, até o Claude Code que
revolucionou a automação em terminal, a codificação com
modelos de linguagem evolui rápido. A novidade agora são sistemas que não
trabalham sozinhos, mas em time.
O Conceito de Sistema Multi-Terminal
O diferencial desse novo workflow é montar um time de agentes AI, cada
um rodando em terminais próprios gerenciados por outro agente principal. Tudo rola
dentro de um ambiente TMUX, sem precisar de monitoramento humano
constante.
Entendendo o TMUX
TMUX (terminal multiplexer) é peça-chave aqui. Ele deixa você ter múltiplas sessões no
terminal, fazendo agentes AI criarem e gerenciarem subterminais de forma isolada. O
contexto fica preservado entre sessões, aumentando produtividade e controle.
Agendador de Tarefas no Terminal
Usando agendamento via terminal, cada agente segue instruções com horários e
prazos fixos, montando um cronograma completo sem intervenção humana. Ele
transforma scripts simples em sistemas orquestrados autônomos.
Como Clonar e Configurar o TMUX Orchestrator
- Passo 1: Navegue até a pasta desejada e clone o repositório com
git clone [link]. - Passo 2: Acesse a pasta
cd TMUX-Orchestratore
rode o script de setup. - Passo 3: Após instalação, inicie uma nova sessão TMUX com
tmux new -s segundo-agente.
Atenção
Tem dois erros conhecidos no repositório que você precisa corrigir na mão.
Esses erros são caminhos fixos com o nome do usuário original e permissões
de execução em comandos Claude.
Corrigindo os Problemas no Repositório
Depois que tiver rodando, edite os arquivos indicados pra trocar referências fixas e
use a flag --dangerous-permissions pra liberar execução sem aprovação
manual em cada terminal.
Atenção
Se você esquecer de adicionar a flag de permissões perigosas, os agentes vão ficar
travados esperando sua autorização, e o processo não sai do lugar.
Organizando os Sub-Terminais
Depois que o agente principal iniciar, ele cria múltiplas janelas TMUX: normalmente uma pro
gestor, uma pro dev e outra pros testes. Dá pra controlar até 8 sessões
ao mesmo tempo de boa.
Estrutura de Pastas do Projeto
O projeto segue uma lógica clara: tem um diretório de orquestração com código-fonte, uma
pasta de especificações (specs) e um task manager. As specs definem o que vai ser
construído e como dividir os times.
Atenção
O arquivo de especificações precisa ter infos claras sobre times, prazos por
fase e componentes. Quanto melhor você definir, mais precisa vai ser a atuação dos
agentes.
Iniciando o Projeto
Abre o Claude no terminal principal, passa o caminho completo pro arquivo .spec e
define direitinho quais times criar (front, back, auth, etc). Claude monta a
estrutura completa a partir daí.
Execução Autônoma em Ciclos
Depois que começa, o sistema cria timers de 15 minutos por fase. Claude manda
atualizações pra cada time, checa progresso e agenda próximos passos
automaticamente. Tem também checkpoints e commits de rollback.
Monitoramento dos Agentes com Checkpoints
A cada ciclo, o agente principal solta um relatório de status mostrando quais
times estão adiantados, horários de conclusão e se fases futuras vão começar. Você
pode aprovar na mão ou deixar tudo automático.
Otimizando Resultados com Referência Visual
Os specs também podem ter imagens e arquivos .md com instruções detalhadas de UI.
Claude entende esse input e usa como blueprint visual pro front-end.
Integração com GitIngest
Pra entender rápido qualquer repositório, troca github.com por gitingest.com , cola no Claude e usa o output resumido pra comandos e
explicações. Isso acelera demais o entendimento.
Atenção
Pra evitar erros, junta todos os comandos necessários num arquivo de instalação e
reutiliza nos setups futuros. Isso mantém tudo consistente e economiza tempo.
Aplicações Futuras e Escalabilidade
Esse setup abre portas pra um fluxo de trabalho escalável, onde vários times
digitais trabalham lado a lado, entregando código de forma coordenada. Quanto melhor
você definir sua spec, mais valor vai gerar.
Checklist de Implementação
- Clonou o repositório e rodou o setup
- Criou uma nova sessão TMUX e inicializou Claude com permissões perigosas
- Corrigiu os dois erros do repositório
- Estruturou os specs com equipes e prazos
- Executou o prompt principal com o caminho do .spec
- Confirmou funcionamento via checagem com TMUX e scheduling
- Acompanhou ciclos com feedbacks a cada 15min
- Incluiu referência visual nas specs de UI
- Testou o funcionamento dos diferentes terminais
- Usou o GitIngest para aprofundar entendimento do repositório